ApsaraVideo Live:SDK の統合

統合環境

SDK パッケージのダウンロード

プッシュ SDK の統合

プッシュ SDK を手動または Pod を使用して統合した後は、権限のリクエストおよび Bitcode の無効化 も行う必要があります。

手動による統合を選択した場合は、手動統合の手順に従ってください。Pod を使用した統合を選択した場合は、Pod 統合の手順に従ってください。

1. 手動統合：

   1. SDK のテストプロジェクトを作成します： App > DemoPush。

   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. [項目を必要に応じてコピー] を選択し、[完了] をクリックします。

   4. SDK をインポートした後、Xcode > 全般 > フレームワーク、ライブラリ、および埋め込みコンテンツ で SDK の依存関係を追加します。

2. Pod 統合：

   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）に置き換えてください。

      • プッシュ SDK と Player SDK（AliyunPlayer）は併用できません。両方の SDK を統合する場合は、All-in-One Media SDK をご使用ください。詳細については、「ユースケース」および「統合」をご参照ください。

   4. ターミナルウィンドウで以下のコマンドを実行します。pod コマンドの実行後、`.xcworkspace` 拡張子を持つプロジェクトファイルが生成されます。このファイルには統合済みの SDK が含まれています。ファイルをダブルクリックして、SDK の更新およびインストールを行います。

      pod install

      または

      pod update

3. 権限のリクエスト

   説明

   カメラおよびマイクへのアクセス権限を追加する必要があります。

   Info.plist ファイルに、カメラおよびマイク用の Privacy - Camera Usage Description および Privacy - Microphone Usage Description 権限を追加します。アプリがバックグラウンドでもアップストリーミングを継続する必要がある場合は、バックグラウンド音声キャプチャモードを有効化します。その際、図に示すとおり、Audio, AirPlay, and Picture in Picture を選択してください。

4. Bitcode の無効化

   SDK は Bitcode をサポートしていません。プロジェクト設定で Bitcode オプションを無効にする必要があります。図に示すとおり、Enable Bitcode を NO に設定してください。

5. ライセンスの設定

   手順については、「ライセンスの統合」をご参照ください。

注意事項

• API の詳細については、「Basic Edition の API リファレンス」をご参照ください。

• API のサンプルコードについては、「機能の使い方」をご参照ください。

よくある質問

コンパイルエラー

以下のコンパイルエラーが表示された場合：Building for iOS, but the linked and embedded framework XXX.framework' was built for iOS + iOS Simulator、以下の手順を実行してください：

1. Xcode メニューをクリックします。

2. ファイル > ワークスペース設定 を選択し、設定ダイアログボックスを開きます。

3. ビルドシステム を 従来のビルドシステム に変更します。

コンパイル時の Queen 依存ライブラリの不足

手動統合時に Queen の依存ライブラリが不足している場合は、「Queen_SDK_iOS」ドキュメントを参照し、必要なライブラリを追加してください。