快速开始

示例项目

千学云 在 Github 上提供了:QXC-iOS-ObjCQXC-iOS-Swift 两个版本的Demo程序,方便您的使用。

前提条件

  • Xcode 9.0 或 以上版本
  • 支持iOS 9.0 或 以上版本的 IOS 设备

集成SDK

使用CocoaPods 自动集成

  1. 确保您已经安装了 CocoaPods 。否则请参考Getting Started CocoaPods 进行安装

  2. 打开 终端,进入项目根目录,并运行 pod init 命令。项目文件夹下会生成一个 Podfile 文本文件

  3. 打开 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
    
  4. 终端 内运行 pod update 命令更新本地库版本。

  5. 运行 pod install 命令安装 SDK 。安装成功项目的文件夹下会自动生成一个 xcworkspace 文件

  6. 打开新生成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

关闭BitCode

关闭Main Thread Checker

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

mainThreadCheckLog

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

关闭Main Thread Checker

Xcode->Product->Scheme->Edit Scheme->Run->Diagnostics

closeMainThreadCheck

results matching ""

    No results matching ""