如何整合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互動版本包含在解壓包的AlivcLivePusher_InteractiveSDK檔案夾中，如下圖所示：互動SDK

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

檔案名稱	檔案說明
AlivcLivePusher_InteractiveSDK/arm	推流SDK互動版本，純arm版本。
AlivcLivePusher_InteractiveSDK/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基礎版：
```
# 推流SDK基礎版 Pod (live pusher pod)
pod 'AlivcLivePusher', '~> 6.17.0'
```
  推流SDK互動版：
```
# 推流SDK互動版本 Pod (live pusher interactive pod)
pod 'AlivcLivePusher_Interactive', '~> 6.17.0'
```
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。
推流SDK升級到4.4.2及以後版本，接入一體化License服務，您需要配置License檔案。具體操作，請參見iOS端配置License。

SDK使用說明

API的詳細說明，請參見iOS基礎版推流SDK介面說明或iOS互動版推流SDK介面說明，或查看SDK包中的API文檔。
API使用範例程式碼，請參見功能使用。