iOS 用プッシュ SDK の統合方法 - ApsaraVideo Live - Alibaba Cloud ドキュメントセンター

このトピックでは、iOS 用のプッシュソフトウェア開発キット (SDK) を統合する方法について説明します。

環境要件

項目	要件
OS バージョン	iOS 8.0 以降
電話モデル	iPhone 7 以降
CPU アーキテクチャ	ARMv7, ARM64
統合ツール	Xcode 8.0 以降
bitcode	シャットダウン

プッシュ SDK のダウンロード

説明

各バージョンには、arm と arm&simulator の 2 つの SDK があります。arm SDK は物理デバイスでのデバッグ専用です。arm&simulator SDK は、物理デバイスとシミュレーターの両方でのデバッグ用です。本番リリースには arm バージョンを使用する必要があります。

必要なバージョンの iOS 用プッシュ SDK を「SDK のダウンロード」からダウンロードします。プッシュ SDK の Basic Edition は、次の図に示すように、解凍されたパッケージの AlivcLivePusher フォルダにあります。 006

次の表に、図に示されているファイルについて説明します。

ファイル名	説明
AlivcLivePusherSDK/arm	プッシュ SDK Basic Edition の arm 専用バージョンです。
AlivcLivePusherSDK/arm&simulator	プッシュ SDK Basic Edition の arm およびシミュレーターバージョンです。

プッシュ SDK の統合

プッシュ SDK を手動または CocoaPods を使用して統合した後、権限をリクエストし、[Bitcode] を無効にし、使用方法を確認する必要もあります。

このプロシージャでは、手動統合と CocoaPods 統合の両方の手順を説明します。選択した方法に適用される手順に従ってください。

手動統合
1. [App] > [DemoPush] という名前の SDK テストプロジェクトを作成します。
2. 次のファイルを Xcode プロジェクトにドラッグします:
  - AlivcLibReplayKitExt.framework
  - AlivcLivePusher.framework
  レタッチ効果とステッカー効果を使用するには、次のファイルもドラッグする必要があります:
  - queen.framework
  - openvc2.framework
  - MNN.framework
  - AliyunQueenUIKit.framework
  プロジェクトが ApsaraVideo Player SDK に依存している場合は、次のファイルもドラッグする必要があります:
  - RtsSDK.framework
  - AliyunPlayer.framework
  - artcSource.framework
  - alivcffmpeg.framework
3. [Copy Items If Needed] を選択し、[Finish] をクリックします。
4. SDK をインポートした後、[Xcode] > [General] > [Frameworks, Libraries, And Embedded Content] の下に依存関係を追加します。
CocoaPods 統合
1. ターミナルウィンドウで、次のコマンドを実行して CocoaPods をインストールします。
  重要
  CocoaPods をインストールする前に、Mac に Ruby 環境がセットアップされていることを確認してください。
```
sudo gem install cocoapods
```
2. プロジェクトのディレクトリに移動し、ターミナルウィンドウで次のコマンドを実行して Podfile を作成します。
```
pod init
```
3. Podfile を編集して、プッシュ SDK の依存関係を追加します。ライブ再生が必要な場合は、ApsaraVideo Player SDK の依存関係を追加することもできます。
```
# プッシュ SDK Basic Edition
pod 'AlivcLivePusher', '~> x.y.z'
```
  説明
  x.y.z はプッシュ SDK のバージョン番号です。「SDK のダウンロード」の最新バージョン番号 (7.4.0 など) に `x.y.z` を置き換えます。
  プッシュ SDK と Player SDK (AliyunPlayer) は同時に統合できません。両方の SDK を統合するには、ApsaraVideo MediaBox SDK を使用する必要があります。詳細については、「シナリオ」および「ApsaraVideo MediaBox SDK の統合」をご参照ください。
4. ターミナルウィンドウで次のコマンドを実行します。コマンドが終了すると、.xcworkspace ファイルが生成されます。このファイルをダブルクリックして、Xcode でプロジェクトを開きます。
```
pod install
```
  または
```
pod update
```
権限のリクエスト
説明
カメラとマイクの権限をリクエストする必要があります。
[Info.plist] ファイルで、[Privacy - Camera Usage Description] キーと [Privacy - Microphone Usage Description] キーを追加して、カメラとマイクへのアクセスをリクエストします。アプリがバックグラウンドでアップストリーミングを継続する必要がある場合は、バックグラウンドオーディオモードを有効にします。これを行うには、図に示すように [Audio, AirPlay, And Picture In Picture] を選択します。
Bitcode の無効化
SDK は Bitcode をサポートしていません。プロジェクトでこのオプションを無効にする必要があります。図に示すように、[Enable Bitcode] を NO に設定します。
ライセンスの設定
詳細については、「プッシュ SDK のライセンスを統合する」をご参照ください。

使用上の注意

API の詳細については、「Basic Edition の 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 ドキュメントを参照して、必要な依存ライブラリを追加してください。