如何整合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檔案夾中，如下圖所示： 006

上圖中的檔案內容區別如下：

檔案名稱	檔案說明
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
3. 勾選Copy items if needed，並單擊Finish。
4. 成功匯入SDK後，在Xcode > General > Frameworks, Libraries, and Embedded Content中添加SDK依賴。
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在後台繼續推流，需要開啟後台音頻採集模式，如圖所示，勾選Audio，AirPlay，and Picture in Picture即可。
關閉Bitcode。
由於SDK不支援Bitcode，所以需要在工程中關閉Bitcode選項，如圖所示，將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文檔添加對應的依賴庫。