IOS SDK 指南
1.下载资源
- 可以下载 Demo、SDK、API文档
现在下载
2.开发语言以及系统要求
- Apple设备：iPhone最低支持iPhone5；
- 系统版本：最低支持iOS 8.0；
- CPU架构：支持真机架构arm64，不支持模拟器i386、 x86架构；
- 其他：不支持bitcode。
3.开发环境
- Xcode 9.0及以上版本；
- Apple开发证书或个人账号；
4.搭建开发环境
4.1. 得到动态库
下载SDK,得到的AutoAIRtcSdk_ios.framework为动态库；
4.2. 创建新的工程
使用XCode创建一个新的工程AutoAIRtcSdk-ios-demo；
4.3. 加入动态库带工程中
将已下载的动态库AutoAIRtcSdk_ios.framework加入到AutoAIRtcSdk-ios-demo工程中Embedded Binaries；
4.4. 打开Xcode
打开Xcode，选择：项目TARGET ->General->Deployment Target，设置8.0或以上版本；
4.5. 使用动态库不需要添加其他库依赖
4.6. 关闭Bitcode（目前SDK版本不支持Bitcode）
4.7. 编辑info.plist，申请摄像头、麦克风权限
Privacy - Camera Usage Description
Privacy - Microphone Usage Description
4.8. 打开后台音频权限
为保障APP退入手机后台之后，通话可以保持不中断，建议开启后台音频权限，SDK默认进入后台之后继续推送音频流。
4.9. 集成成功
按照上述步骤完成AutoAIRtcSdk-ios-demo的前期SDK集成准备之后，请使用Xcode连接iPhone真机，在真机调试环境下，执行编译Commond + B，提示Build Success，表示SDK集成成功。
5. 初始化
建议在初始化 App 的同时，初始化 SDK。
5.1. 导入 SDK 头文件
5.2. 设置 userId 和 roomId，获取AppID;
AutoAIRtcEngine *engine = [[AutoAIRtcEngine alloc] initWithUserId:userId appId:appId roomId:roomId]];
务必要设置代理对象，并实现代理回调方法，设置代理对象失败，会导致 App 收不到相关回调。
engine.delegate = self;
5.3. 配置参数 初始化完成后，即可调用 SDK 相关接口，实现对应功能。
使用之前需要对SDK进行相关设置，如果不设置，系统将会采用默认值。
self.engineMode = AutoAIRtcEngineModeTrival; 默认为测试模式 self.engine.isAutoPublish = YES;//加入房间后将自动发布本地音视频 默认为YES self.engine.isAutoSubscribe = YES;//加入房间后将自动订阅远端音视频 默认为YES self.engine.isOnlyAudio = NO;//将启用纯音频模式 默认为NO self.engine.isDebug = NO;//是否开启日志 self.engine.videoProfile = AutoAIRtcEngine_VideoProfile_360P_1;//设置视频分辨率 self.engine.streamProfile = AutoAIRtcEngine_StreamProfileAll;//设置流权限
6. 建立通话
6.1. 加入房间
[self.engine joinRoomWithcompletionHandler:^(NSData *data, NSUrlResponse *response, NSError error) {
}];
6.2. 发布本地流
1）自动发布模式下，joinRoom成功后，即可发布本地流，无需再次调用publish接口；
2）手动发布模式下，joinRoom成功后，可通过下述接口发布本地流；
[self.engine publish];
3）发布过程中可以监听以下事件获取发布状态，根据状态调用渲染或其他接口即可。
- (void)uCloudRtcEngine:(AutoAIRtcEngine *)manager didChangePublishState:(AutoAIRtcEnginePublishState)publishState {
switch (publishState) {
case AutoAIRtcEnginePublishStateUnPublish:
self.isConnected = NO;
break;
case AutoAIRtcEnginePublishStatePublishing: {
[self.bottomButton setTitle:@"正在发布..." forState:UIControlStateNormal];
}
break;
case AutoAIRtcEnginePublishStatePublishSucceed:{
self.isConnected = YES;
[self.view makeToast:@"发布成功" duration:1.5 position:CSToastPositionCenter];
[self.bottomButton setTitle:@"发布成功" forState:UIControlStateNormal];
}
break;
case AutoAIRtcEnginePublishStateRepublishing: {
[self.bottomButton setTitle:@"正在重新发布..." forState:UIControlStateNormal];
}
break;
case AutoAIRtcEnginePublishStatePublishFailed: {
self.isConnected = NO;
[self.bottomButton setTitle:@"开始发布" forState:UIControlStateNormal];
}
break;
case AutoAIRtcEnginePublishStatePublishStoped: {
self.isConnected = NO;
[self.view makeToast:@"发布已停止" duration:1.5 position:CSToastPositionCenter];
[self.bottomButton setTitle:@"开始发布" forState:UIControlStateNormal];
}
break;
default:
break;
}
}
```
### 6.3. 取消发布本地流
[self.engine unPublish];
### 6.4. 订阅远程流 1）自动订阅模式下，joinRoom成功后，即可订阅远程流，无需再次调用subscribeMethod接口； 2）手动订阅模式下，joinRoom成功后，可通过下述接口订阅远程流；
[self.engine subscribeMethod:remoteStream];
3）订阅成功，在回调事件中调用渲染接口即可。
-(void)uCloudRtcEngine:(AutoAIRtcEngine *)channel didSubscribe:(AutoAIRtcStream *)stream{
[self reloadVideos];
}
### 6.5. 取消订阅远程流
[self.engine unSubscribeMethod:remoteStream];
### 6.6. 离开房间
[self.engine leaveRoom]; ```