快速开始
示例项目
千学云 在 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