如何整合iOS端推流SDK - ApsaraVideo Live

通過閱讀本文，您可以快速瞭解如何整合iOS端推流SDK。

Integration Environment

名稱	要求
系統版本	支援iOS 8.0及以上版本。
機器型號	支援iPhone 7及以上。
CPU架構支援	ARMv7、ARM64。
整合工具	Xcode 8.0及以上版本。
bitcode	關閉。

推流SDK下載

說明

每個版本均包含arm和arm&simulator兩套SDK，arm僅支援真機調試。arm&simulator支援真機+模擬器調試。專案在release上線的時候必須使用arm版本。

在SDK下載下載對應版本的iOS端推流SDK，推流SDK基礎版包含在解壓包的AlivcLivePusher檔案夾中。

SDK 目錄 AlivcLivePusherSDK 下的 arm 檔案夾包含以下 framework：

AlivcLibReplayKitExt.framework
AlivcLivePusher.framework

檔案內容區別如下：

檔案名稱	檔案說明
AlivcLivePusherSDK/arm	推流SDK基礎版，純arm版本。
AlivcLivePusherSDK/arm&simulator	推流SDK基礎版，arm+模擬器版本。

推流SDK整合

通過手動或Pod方式整合推流SDK後，您還需要添加請求許可權、關閉Bitcode，以及查看具體使用說明。

如果您選擇手動整合推流SDK，請參考操作步驟中手動整合方法；如果選擇Pod整合推流SDK，請參考操作步驟中Pod整合方法。

手動整合：
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
  在 Xcode 專案 General > Frameworks, Libraries, and Embedded Content 中，按以下嵌入方式配置各依賴架構：
  - Embed & Sign：alivcffmpeg.framework、AlivcLibReplayKitExt.framework、AlivcLibRtmp.framework、AlivcLivePusher.framework、AliyunPlayer.framework、artcSource.framework、opencv2.framework
  - Embed Without Signing：AlivcLiveBroadcast.appex
  - Do Not Embed：Accelerate.framework、CoreGraphics.framework、CoreImage.framework、CoreMedia.framework、CoreMotion.framework、CoreVideo.framework、Face3D.framework、FaceDetection.framework、Foundation.framework、Metal.framework、MNN.framework、OpenGLES.framework、pixelai.framework、QuartzCore.framework、queen.framework
3. 勾選Copy items if needed，並單擊Finish。
4. 成功匯入SDK後，在Xcode > General > Frameworks, Libraries, and Embedded Content中添加SDK依賴。在 Frameworks, Libraries, and Embedded Content 中，將 alivcffmpeg.framework、AlivcLibRtmp.framework、AlivcLivePusher.framework、AliyunPlayer.framework、artcSource.framework、RtsSDK.framework、opencv2.framework 等第三方架構的嵌入方式設定為 Embed & Sign，系統架構（如 Accelerate、CoreGraphics、CoreMedia 等）保持 Do Not Embed，AlivcLiveBroadcast.appex 設定為 Embed Without Signing。
Pod整合：
1. 在終端視窗中輸入以下命令，安裝CocoaPods。
  重要
  請提前在Mac中安裝Ruby環境。
```
sudo gem install cocoapods
```
2. 進入專案所在路徑，在終端視窗中輸入以下命令，建立Podfile檔案。
```
pod init
```
3. 編輯Podfile檔案，添加直播SDK依賴。如需直播播放，可以添加阿里雲播放器SDK依賴。
```
#基礎版推流SDK
pod 'AlivcLivePusher', '~> x.y.z'
```
  說明
  x.y.z 表示推流 SDK 的版本號碼。您可以在 SDK下載中查看最新版本號碼，並將其替換為實際值（例如 7.4.0）。
  推流SDK暫不支援與播放器SDK（AliyunPlayer）同時整合，若是需要同時整合推流SDK和播放器SDK，您可以選擇音視頻終端一體化SDK。具體資訊可參見音視頻終端一體化SDK使用情境說明，一體化SDK整合。
4. 在終端視窗中輸入以下命令。pod命令執行完成後，會產生整合了的SDK的.xcworkspace尾碼的工程檔案，雙擊開啟即可更新並安裝SDK。
```
pod install
```
  或者
```
pod update
```
添加請求許可權。
說明
請務必添加錄音許可權和相機許可權。
在Info.plist檔案中添加網路攝影機和麥克風許可權Privacy - Camera Usage Description、Privacy - Microphone Usage Description，並填寫對應的許可權用途描述。如果需要 App 在後台繼續推流，需要在 Xcode 專案的 Capabilities 標籤頁中將 Background Modes 開關設為 ON，並在展開的 Modes 列表中勾選 Audio, AirPlay, and Picture in Picture。
關閉Bitcode。
由於SDK不支援Bitcode，所以需要在工程中關閉Bitcode選項。在 Xcode 專案的 Build Settings 中搜尋 bitcode，將 Build Options 下的 Enable Bitcode 設定為 No。
配置License。
操作指引，請參見License整合指南。

使用說明

API詳細說明，請參見基礎版API文檔。
API使用範例程式碼，請參見功能使用。

常見問題

編譯報錯

當您收到Building for iOS, but the linked and embedded framework XXX.framework' was built for iOS + iOS Simulator編譯報錯時，請參見如下操作：

單擊Xcode菜單。
選擇File > Workspace Settings進入對話方塊設定。
選擇將build System更改為Legacy build system即可。

當編譯缺少Queen的依賴庫時

手動整合的情況下，出現Queen缺少依賴庫的情況時，可以參見Queen_SDK_iOS文檔添加對應的依賴庫。