跳转到主要内容

​
step 1：初始化SDK

​
创建初始化参数

在调用 SDK 的任何其他函数之前，需要进行 SDK 初始化。要初始化 SDK，请创建RTCEngineConfig对象的实例。 
RTCEngineConfig *engineConfig = [[RTCEngineConfig alloc] init];
engineConfig.enableLocalLog = YES;
  • 下表描述了RTCEngineConfig对象的所有属性。
参数名必填说明
logPath否日志文件路径，默认沙盒 Document 目录
enableLocalLog否是否启用本地日志，默认 NO

​
初始化RTC引擎

创建 RTCEngineConfig 对象后，调用 SDK 的 initializeWithConfig 函数设置代理并验证它是否已正确初始化。 
RTCEngineError errorCode = [[RTCEngineKit sharedEngine] initializeWithConfig:self.engineConfig appGroup:@"Application Group Identifier" delegate:self];
if (errorCode != RTCEngineErrorOK) {
    NSLog(@"初始化RTC服务失败");
}

​
设置委托

若要订阅委托事件，必须创建 RTCEngineDelegate 的实例，并使您的类符合 RTCEngineDelegate 协议。 
@interface YourClass : NSObject <RTCEngineDelegate>
/// 根据需要，在此处添加以下任何回调函数。

​
实现回调函数

  • 加入频道成功回调
/// 加入频道成功回调
/// @param channel 频道名称
/// @param userId 用户标识
- (void)onJoinSucceed:(NSString *)channel userId:(NSString *)userId {
    
    NSLog(@"加入频道成功 channel = %@, userId = %@", channel, userId);
}
  • 自己数据更新回调
/// 自己数据更新回调
/// @param channel 频道名称
/// @param userId 用户标识
- (void)onUserUpdate:(NSString *)channel userId:(NSString *)userId {
    
    NSLog(@"加入频道成功 channel = %@, userId = %@", channel, userId);
}
  • 开始重连回调
/// 开始重连回调
- (void)onReconnecting {
    
    NSLog(@"连接已经断开，组件开始尝试重连。");
}
  • 重连成功回调
/// 重连成功回调
- (void)onReconnected {
    
    NSLog(@"服务连接/重连成功。");
}
  • 连接断开回调
/// 连接断开回调
/// 发生不可恢复的错误或者被动离开频道，这个事件触发需要重新获取令牌
/// @param reason 离开原因
/// @param errCode 错误码
/// @param errMsg 错误信息
- (void)onDisconnected:(RTCLeaveReason)reason errCode:(RTCEngineError)errCode errMsg:(nullable NSString *)errMsg {
    
    NSLog(@"当前连接断开或被动离开频道，请重新登录 reason = %ld, errCode = %ld, errMsg = %@", reason, errCode, errMsg);
}
  • 自定义消息回调
/// 自定义消息回调
/// @param content 消息内容
/// @param action 消息标识
/// @param userId 用户标识
- (void)onCustomMessage:(NSString *)content action:(NSString *)action userId:(nullable NSString *)userId {
    
    NSLog(@"接收到自定义消息 action = %@ content = %@", action, content);
}
  • 频道更新回调
/// 频道更新回调
/// @param channel 频道名称
/// @param props 自定义数据
- (void)onChannelUpdate:(NSString *)channel props:(NSString *)props {
    
    NSLog(@"频道数据更新 channel = %@, props = %@", channel, props);
}
  • 用户加入频道回调
/// 用户加入频道回调
/// @param channel 频道名称
/// @param userId 用户标识
- (void)onRemoteUserJoinChannel:(NSString *)channel userId:(NSString *)userId {
    
    NSLog(@"通知有用户加入频道 channel = %@, userId = %@", channel, userId);
}
  • 成员数据更新回调
/// 成员数据更新回调
/// @param channel 频道名称
/// @param userId 用户标识
- (void)onRemoteUserUpdate:(NSString *)channel userId:(NSString *)userId {
    
    NSLog(@"通知成员数据更新 channel = %@, userId = %@", channel, userId);
}
  • 用户离开频道回调
/// 用户离开频道回调
/// @param channel 频道名称
/// @param userId 用户标识
/// @param reason 离开原因
- (void)onRemoteUserLeaveChannel:(NSString *)channel userId:(NSString *)userId reason:(RTCLeaveReason)reason {
    
    NSLog(@"通知有用户离开频道 channel = %@, userId = %@", channel, userId);
}
  • 用户码流数据变更回调
/// 用户码流数据变更回调
/// @param channel 频道名称
/// @param userId 用户标识
/// @param streamTrackModel 码流轨道数据
/// @param changeType 操作类型
- (void)onRemoteStreamTrackChange:(NSString *)channel userId:(NSString *)userId streamTrackModel:(RTCEngineStreamTrackModel *)streamTrackModel changeType:(RTCChangeType)changeType {
    
    NSLog(@"用户码流数据发生变更 channel = %@, userId = %@, streamTrackModel = %@", channel, userId, streamTrackModel);
}

​
step 2：加入和离开频道

​
加入频道

RTCEngineError errorCode = [[RTCEngineKit sharedEngine] joinChannelWithToken:@"Your Token"];
if (errorCode != RTCEngineErrorOK) {
    NSLog(@"加入频道失败");
}

​
离开频道

[[RTCEngineKit sharedEngine] leaveChannel:^{
    /// TO DO...
}];

​
step 3：发布视频流

​
开启预览画面

[[RTCEngineKit sharedEngine] startLocalPreview:YES view:self.localView];

​
更新预览画面

[[RTCEngineKit sharedEngine] updateLocalView:self.localView];

​
停止预览画面

[[RTCEngineKit sharedEngine] stopLocalPreview];

​
恢复/暂停推流

[[RTCEngineKit sharedEngine] publishLocalVideo:YES];

​
step 4：订阅和取消订阅远端视频

​
订阅远端用户的视频流

[[RTCEngineKit sharedEngine] startRemoteView:userId trackId:trackId view:self.previewView];
  • 下表描述了RTCTrackIdentifierFlags轨道标识枚举类型的所有值。
枚举名枚举值说明
RTCTrackIdentifierFlags00轨道0
RTCTrackIdentifierFlags11轨道1
RTCTrackIdentifierFlags22轨道2
RTCTrackIdentifierFlags33轨道3
RTCTrackIdentifierFlags44轨道4
RTCTrackIdentifierFlags55轨道5
RTCTrackIdentifierFlags66轨道6

​
更新远端用户的视频流

[[RTCEngineKit sharedEngine] updateRemoteView:userId trackId:trackId view:self.previewView];

​
停止订阅远端用户的视频流

[[RTCEngineKit sharedEngine] stopRemoteView:userId trackId:trackId];

​
停止订阅指定远端用户的所有视频流

[[RTCEngineKit sharedEngine] stopAllRemoteViewWithUserId:userId];

​
step 5：销毁资源

[[RTCEngineKit sharedEngine] destroy];