阿里云 RTC 的基本功能包含初始化 SDK、加入频道、本地发布和订阅远端、离开频道等。当您成功初始化 SDK，您可以进行本地预览视频功能，进行简单的预览和测试。当您操作本地发布和订阅远端时，可以设置手动或者自动模式。
前提条件
在实现基本功能前，请您确保下载最新 SDK，请参见 SDK 下载。
获得加入频道必须的频道鉴权令牌（Token）：
- 您可以在控制台生成临时 Token 校验加入频道是否成功，详情请参见控制台生成 Token。
- 在安全要求更高的场景下，建议您在服务端生成 Token，详情请参见服务端生成 Token。
说明 本文中的实现方法为主要功能方法，仅供参考，您可以根据业务需求进行实际开发。
操作步骤
- 请您先初始化 SDK。首先您需要创建 AliRtcEngine 实例，并注册 AliRtcEngineDelegate 监听相关回调。如果您在 ViewController 中持有 AliRtcEngine 实例，请声明属性。
@interface ViewController () <AliRtcEngineDelegate> @property (nonatomic, strong) AliRtcEngine *engine; @end
Mac 回调详情请参见回调及监听。
self.engine = [AliRtcEngine sharedInstance:self extras:@""];
说明目前 SDK 暂不支持多实例。
- 本地预览。在创建完 AliRtcEngine 实例后，您可以创建 canvas 布局进行本地预览视频。
AliVideoCanvas *canvas = [[AliVideoCanvas alloc] init]; canvas.renderMode = AliRtcRenderModeAuto; canvas.view = (AliRenderView *)view; /* 预览窗口view */ canvas.mirrorMode = AliRtcRenderMirrorModeOnlyFrontCameraPreviewEnabled; [self.engine setLocalViewConfig:canvas forTrack:AliRtcVideoTrackCamera]; [self.engine startPreview];
说明
- AliRtcRenderMode 提供四种渲染模式。
- （推荐）AliRtcRenderModeAuto：自动模式。
- AliRtcRenderModeStretch：拉伸填充视图，不保持视频比例。
- AliRtcRenderModeFill：在保持视频宽高比的同时缩放，填充黑边。
- AliRtcRenderModeCrop：在保持视频宽高比的同时缩放，并裁剪以适合视图。
- view 必须是 AliRenderView 或者其子类。
- AliRtcRenderMirrorMode 在本地或远端均可设置镜像模式，并提供三种镜像模式。
- AliRtcRenderMirrorModeOnlyFrontCameraPreviewEnabled：只有前置摄像头预览镜像，其余不镜像。
- AliRtcRenderMirrorModeAllEnabled：全部镜像。
- AliRtcRenderMirrorModeAllDisabled：全部不镜像。
您也可以取消本地预览。
[self.engine stopPreview];
- 设置自动或者手动模式。阿里云音视频通信 Mac 端默认实现自动发布和订阅，您也可以通过代码手动发布和订阅。
- 自动发布模式： 如果您打开自动发布模式，加入频道之后，SDK 将自动开始发布音视频流；如果关闭自动发布模式，则需要您调用 publish 接口之后才会发布音视频流。
- 自动订阅模式： 如果您打开自动订阅模式，加入频道之后，SDK 将会自动订阅当前频道内其他人的音视频流；如果关闭自动订阅模式，则需要您调用 subscribe 接口之后才会订阅其他人的音视频流。
/* 设置自动发布和订阅，只能在加入频道之前配置。 autoPublish：是否自动发布。取值：YES|NO。 autoSubscribe：是否自动订阅。取值：YES|NO。 */ [self.engine setAutoPublish:YES withAutoSubscribe:YES];
- 加入频道。
AliRtcAuthInfo *authinfo = [[AliRtcAuthInfo alloc]init]; authinfo.channel = /* 您的channelId */; authinfo.appid = /* 您的Appid */; authinfo.nonce = /* 您的nonce */; authinfo.user_id = /* 您的userId */; authinfo.token = /* 您的token */; authinfo.timestamp = /* 您的timestamp */; authinfo.gslb = /* 您的gslb地址 */; [self.engine joinChannel:authinfo name:/* userName */ onResult:^(NSInteger errCode){ // 加入频道UI处理 }];
| 参数 | 描述 |
| AppID | 应用 ID，在控制台应用管理页面创建和查看。 |
| ChannelId | 频道 ID。1~64 位，支持大小写字母、数字、下划线（_）、中划线（-）。 |
| UserId | 用户 ID。1~64 位，支持大小写字母、数字、下划线（_）、中划线（-）。 说明 同一个用户 ID 在其他端登录，先入会的端会被后入会的端踢出频道。 |
| Nonce | 随机码。需要加上前缀 AK-，由字母 [a-zA-Z] 和数字 [0-9] 组成，不包含特殊字符，最大 64 字节。例如：AK-2b9be4b25c2d38c409c376ffd2372be1。 |
| TimeStamp | 频道过期时间戳。代表令牌有效时间为当前时间 + 所选择小时数。 |
| Token | 频道鉴权令牌，计算方法：token = sha256(appId + appKey + channelId + userId + nonce + timestamp)。 |
| GSLB | 服务地址，该参数是数组类型，当前请使用：["https://rgslb.rtc.aliyuncs.com"]，请您通过业务服务器下发到客户端 SDK，不建议您将该地址固化在客户端代码。 |
- 发布或取消发布本地流。发布本地流。
- 自动发布模式下：加入频道成功后，即可发布本地流，无需再次调用 publish 接口。
- 手动发布模式下：加入频道成功后，可通过以下接口发布本地流。
如果发布过程中需要变更配置或者停止发布，需要按如下流程先重新设置配置参数，然后再调用 publish 接口。
//YES表示允许发布音频流，NO表示不允许 [self.engine configLocalAudioPublish:YES]; //YES表示允许发布相机流，NO表示不允许 [self.engine configLocalCameraPublish:YES]; //YES表示允许发布次要视频流；NO表示不允许 [self.engine configLocalSimulcast:YES forTrack:AliRtcVideoTrackCamera]; [self.engine publish:^(int err) { // 相关UI操作 }];
取消发布本地流。
[self.engine configLocalAudioPublish:NO]; [self.engine configLocalCameraPublish:NO]; [self.engine configLocalSimulcast:NO forTrack:AliRtcVideoTrackCamera]; [self.engine publish:^(int err) { // 取消相关UI操作 }];
- 订阅或取消订阅远程流。订阅远程流。
- 自动订阅模式下：加入频道成功后，即可订阅远端流，无需再次调用 subscribe 接口。
- 手动订阅模式下：加入频道成功后，可通过以下接口订阅远端流。
无论是自动模式还是非自动模式，当您订阅成功后，通过 delegate 可以获取订阅的 callback，然后您可以进行相关 UI 操作或逻辑处理。
- (void)onSubscribeChangedNotify:(NSString *)uid audioTrack:(AliRtcAudioTrack)audioTrack videoTrack:(AliRtcVideoTrack)videoTrack { dispatch_async(dispatch_get_main_queue(), ^{ // UI或者逻辑处理，例如渲染远端视频流的操作如下 if(videoTrack & AliRtcVideoTrackCamera) { // camera track AliVideoCanvas *canvas = [[AliVideoCanvas alloc] init]; canvas.renderMode = /* renderMode */; canvas.view = (AliRenderView *)view;/* 渲染view */ [self.engine setRemoteViewConfig:canvas uid:uid forTrack:AliRtcVideoTrackCamera]; } }); }
您可以通过下述 delegate 回调监听远端用户的流状态变更。例如，手动模式下，收到此回调后，可以获取到远端用户的发布状态，然后相应做出订阅（subscribe）操作，或者更新 UI 等。
- (void)onRemoteTrackAvailableNotify:(NSString *)uid audioTrack:(AliRtcAudioTrack)audioTrack videoTrack:(AliRtcVideoTrack)videoTrack { }
取消订阅远程流。
[self.engine configRemoteAudio:/* remoteUserID */ enable:NO]; [self.engine configRemoteScreenTrack:/* remoteUserID */ enable:NO]; [self.engine configRemoteCameraTrack:/* remoteUserID */ preferMaster:YES enable:NO]; [self.engine subscribe:/* remoteUserID */ onResult:^(NSString *uid, AliRtcVideoTrack vt, AliRtcAudioTrack at) { }];
- 离开频道。
[self.engine leaveChannel];
您可以下载示例代码，快速跑通 Demo，实现频道内和其他人进行实时音视频通话，详情请参见 Mac Demo。
「视频云技术」你最值得关注的音视频技术公众号，每周推送来自阿里云一线的实践技术文章，在这里与音视频领域一流工程师交流切磋。
