快速开始
示例项目
千学云 在 Github 上提供了:QXC-iOS-ObjC 和 QXC-iOS-Swift 两个版本的Demo程序,方便您的使用。
前提条件
- Xcode 9.0 或 以上版本
- 支持iOS 9.0 或 以上版本的 IOS 设备
集成SDK
使用CocoaPods 自动集成
确保您已经安装了 CocoaPods 。否则请参考Getting Started CocoaPods 进行安装
打开 终端,进入项目根目录,并运行
pod init命令。项目文件夹下会生成一个Podfile文本文件打开
Podfile文件,修改为如下内容。注意:Your Target需要替换成您的Target名称source 'https://github.com/CocoaPods/Specs.git' source 'https://git.qianxuecloud.com/qianxue/qianxuepodspecs.git' target 'Your Target' do use_frameworks! pod 'QXCLiveSDK' end在 终端 内运行
pod update命令更新本地库版本。运行
pod install命令安装 SDK 。安装成功项目的文件夹下会自动生成一个xcworkspace文件打开新生成
xcworkspace文件
添加媒体设备权限
添加必要媒体设备权限,如果没有添加权限,调起相关服务时,工程会崩溃。
在你的info.plist 文件中,点击 + 图标添加相应的权限
| Key | Type | Value |
|---|---|---|
| Privacy - Camera Usage Description | String | 千学云想要访问您的摄像头用于直播 |
| Privacy - Microphone Usage Description | String | 千学云想要访问您的麦克风用于直播 |
添加后:

关闭BitCode
如果没有关闭 bitcode 会有如下错误
does not contain bitcode. You must rebuild it with bitcode enabled (Xcode setting ENABLE_BITCODE), obtain an updated library from the vendor, or disable bitcode for this target.
再项目中的 Build Settings --> Build Options --> Enable BitCode 设置为 NO

关闭Main Thread Checker
集成 SDK 后,在 debug 调试模式下,进入直播间会迟迟不出现画面情况,而且会在 log 输出台出打印相关日志。

此时建议关闭工程的Main Thread Chaecker 功能。出现这个问题,是因为SDK在拉取到视频流时,会在异步线程获取当前设备状态的方向,来保证输出画面的正确性,由于Xcode的检测机制,导致画面出现延迟,这个问题在Release模式下是不受影响的。
关闭Main Thread Checker:
Xcode->Product->Scheme->Edit Scheme->Run->Diagnostics
