SDK集成

集成环境

推流SDK下载

推流SDK集成

通过手动或Pod方式集成推流SDK后，您还需要添加请求权限、关闭Bitcode，以及查看具体使用说明。

如果您选择手动集成推流SDK，请参考操作步骤中手动集成方法；如果选择Pod集成推流SDK，请参考操作步骤中Pod集成方法。

1. 手动集成：

   1. 新建SDK测试工程，App > DemoPush。

   2. 分别将以下文件拖入您的Xcode工程中：

      • AlivcLibReplayKitExt.framework

      • AlivcLivePusher.framework

      如需使用美颜和贴纸特效，还需拖入以下文件：

      • queen.framework

      • openvc2.framework

      • MNN.framework

      • AliyunQueenUIKit.framework

      如需依赖阿里云播放器SDK的版本，还需拖入以下文件：

      • RtsSDK.framework

      • AliyunPlayer.framework

      • artcSource.framework

      • alivcffmpeg.framework

   3. 勾选Copy items if needed，并单击Finish。

   4. 成功导入SDK后，在Xcode > General > Frameworks, Libraries, and Embedded Content中添加SDK依赖。

2. Pod集成：

   1. 在终端窗口中输入以下命令，安装CocoaPods。

      重要

      请提前在Mac中安装Ruby环境。

      sudo gem install cocoapods

   2. 进入项目所在路径，在终端窗口中输入以下命令，创建Podfile文件。

      pod init

   3. 编辑Podfile文件，添加直播SDK依赖。如需直播播放，可以添加阿里云播放器SDK依赖。

      #以下SDK请根据自己的业务需要，选择一种接入即可
      
      #1.基础版推流SDK（不支持连麦）
      pod 'AlivcLivePusher', '~> x.y.z'
      #2.互动版推流SDK（支持连麦）
      pod 'AlivcLivePusher_Interactive', '~> x.y.z'

      说明

      • x.y.z 表示推流 SDK 的版本号。您可以在 SDK下载 中查看最新版本号，并将其替换为实际值（例如 7.1.0）。

      • 推流SDK暂不支持与播放器SDK（AliyunPlayer）同时集成，若是需要同时集成推流SDK和播放器SDK，您可以选择音视频终端一体化SDK。具体信息可参见音视频终端一体化SDK使用场景说明，多模块组合集成。

   4. 在终端窗口中输入以下命令。pod命令执行完成后，会生成集成了的SDK的.xcworkspace后缀的工程文件，双击打开即可更新并安装SDK。

      pod install

      或者

      pod update

3. 添加请求权限。

   说明

   请务必添加录音权限和相机权限。

   在Info.plist文件中添加摄像头和麦克风权限Privacy - Camera Usage Description、Privacy - Microphone Usage Description。如果需要App在后台继续推流，需要打开后台音频采集模式，如图所示，勾选Audio，AirPlay，and Picture in Picture即可。

4. 关闭Bitcode。

   由于SDK不支持Bitcode，所以需要在工程中关闭Bitcode选项，如图所示，将Enable Bitcode置为NO状态即可。

5. 配置License。

   操作指引，请参见License集成指南。

使用说明

• API详细说明，请参见基础版API文档或互动版API文档。

• API使用示例代码，请参见功能使用。

常见问题

编译报错

当您收到Building for iOS, but the linked and embedded framework XXX.framework' was built for iOS + iOS Simulator编译报错时，请参见如下操作：

1. 单击Xcode菜单。

2. 选择File > Workspace Settings进入对话框设置。

3. 选择将build System更改为Legacy build system即可。

当编译缺少Queen的依赖库时

手动集成的情况下，出现Queen缺少依赖库的情况时，可以参见Queen_SDK_iOS文档添加对应的依赖库。