ApsaraVideo Live:SDK のダウンロードとインテグレーション

前提条件

要件：

• Android Studio 2020.3.1 以降。

• Android 5.0 (SDK API レベル 21) 以降が動作し、ネットワークに接続されたテストデバイス。

ステップ 1：SDK のインポート

ステップ 2：CPU アーキテクチャの設定

app/build.gradle の defaultConfig ブロックで、サポートする CPU アーキテクチャを指定します。利用可能なアーキテクチャ：armeabi-v7a、arm64-v8a、x86、および x86_64

android {
    defaultConfig {
        // ...その他のデフォルト設定
        // armeabi-v7a および arm64-v8a アーキテクチャをサポートします。
        ndk {
             abiFilters "armeabi-v7a", "arm64-v8a"
        }
    }
}

ステップ 3：権限の設定

AndroidManifest.xml (app/src/main) に、必要な権限を追加します。

<uses-feature android:name="android.hardware.camera" android:required="false" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- 古いデバイスで従来の Bluetooth 権限をリクエストします。 -->
<uses-permission
  android:name="android.permission.BLUETOOTH"
  android:maxSdkVersion="30" />
<uses-permission
  android:name="android.permission.BLUETOOTH_ADMIN"
  android:maxSdkVersion="30" />

<!-- アプリが既にペアリング済みの Bluetooth デバイスと通信する場合にのみ必要です。 -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WRITE_SETTINGS"
  tools:ignore="ProtectedPermissions" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove"/>

<!-- Bluetooth 権限を宣言します。 -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<!-- API 31以降で必要な BLUETOOTH_CONNECT 権限を削除します。 -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

<!-- 下位互換性のために android:maxSdkVersion を 30 に設定して Bluetooth 権限を宣言します。 -->
<uses-permission android:name="android.permission.BLUETOOTH"/>
<!-- 高バージョン API 31+ の Bluetooth 権限を宣言します。 -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>
<!-- その他の Bluetooth 権限 -->

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    String[] permissions = {
        android.Manifest.permission.BLUETOOTH_CONNECT
    };
    ActivityCompat.requestPermissions(activity, permissions, REQUEST_BLUETOOTH);
}

<!-- ARTC SDK に組み込まれている Bluetooth 権限の宣言を削除します。 -->
<uses-permission android:name="android.permission.BLUETOOTH" tools:node="remove" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

ステップ 4：難読化の防止 (オプション)

SDK コードが難読化されないように、次のルールを app/proguard-rules.pro に追加します。

-keep class com.aliyun.allinone.** {
*;
}

-keep class com.aliyun.rts.network.AliHttpTool {
*;
}

-keep class com.aliyun.common.AlivcBase {
*;
}

-keep class com.huawei.multimedia.alivc.** {
*;
}

-keep class com.alivc.rtc.** {
*;
}

-keep class com.alivc.component.** {
*;
}

-keep class org.webrtc.** {
*;
}

前提条件

要件：

• Xcode 14.0 以降 (最新の安定バージョンの使用を推奨します)。

• CocoaPods 1.9.3 以降。

• iOS 9.0 以降を搭載した物理デバイス。

ステップ 1：SDK のインポート

ステップ 2：権限の設定

• Info.plist にカメラとマイクの権限を追加します：[Privacy - Camera Usage Description] と [Privacy - Microphone Usage Description]。

• (オプション) バックグラウンドオーディオを有効にします。プロジェクトの機能で、[Audio, AirPlay, and Picture in Picture] を選択します。

前提条件

要件：

• Visual Studio 2015 以降。

• Windows 7 以降。

ステップ 1：SDK のインテグレーション

1. 「SDK のダウンロード」セクションから最新の ARTC SDK をダウンロードします。

2. SDK を展開し、すべてのファイルをプロジェクトディレクトリにコピーします。

3. プロジェクトのプロパティを設定します。

   1. ソリューション エクスプローラーでプロジェクトを右クリックし、[プロパティ] を選択します。

   2. インクルードディレクトリを追加します：[構成プロパティ] > [C/C++] > [全般] を選択し、[追加のインクルード ディレクトリ] にヘッダーファイルのパスを追加します。

   3. ライブラリディレクトリを追加します：[リンカー] > [全般] を選択し、[追加のライブラリ ディレクトリ] にライブラリファイル (.lib) のパス (例：.../x64/Release) を追加します。

   4. リンクするライブラリファイルを指定します：[リンカー] > [入力] を選択し、[追加の依存ファイル] に AliRTCSdk.lib を追加します。

トラブルシューティング

一般的な問題と解決策：

前提条件

要件：

• Xcode 14.0 以降 (最新の安定バージョンの使用を推奨します)。

• macOS 10.13 以降。

• 安定したネットワーク接続。

ステップ 1：SDK のインテグレーション

Mac 用 ARTC SDK は、.framework 動的ライブラリバンドル (例：AliRTCSdk.framework) として提供されます。これは、Linux で使用される .so 共有ライブラリとは異なります。Mac SDK パッケージをダウンロードし、Linux パッケージの .so ファイルは使用しないでください。

1. SDK のダウンロード セクションから最新の ARTC SDK をダウンロードして展開します。

2. SDK パッケージから .framework バンドルをプロジェクトディレクトリにコピーします。AAC 音声エンコーディングを使用しない場合は、PluginAAC.framework をスキップしてください。

3. Xcode で、動的ライブラリを追加し、[Embed] を 埋め込んで署名 に設定します。

トラブルシューティング

一般的な問題と解決策：

ARTC SDK を使用すると、追加の Android 権限が必要になりますか？

ARTC SDK は、以下の Android 権限を自動的に宣言します (正確なリストはバージョンによって異なる場合があります。.aar ファイル内の AndroidManifest.xml を確認してください)。

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

これらの権限は、ネットワーク監視、Wi-Fi 検出、Bluetooth 接続、およびオーディオルーティングをサポートします。

既存のコードとの権限の互換性や競合はどのように処理すればよいですか？

ARTC SDK は権限の互換性 (例：Android 12 以降でのランタイム BLUETOOTH_CONNECT) を処理しますが、問題が発生する可能性があります。

• マニフェストのマージ失敗など、ランタイムの動作異常。

• Google Play の審査リスク：未使用の権限 (例：Bluetooth) を宣言すると、最小権限の原則に違反し、リジェクトの原因となる可能性があります。

これらの問題を解決するには：

1. 必要性を評価する。未使用の権限を削除します。たとえば、targetSdk が 30 以下の場合、BLUETOOTH_CONNECT 宣言を削除します。

2. マニフェストのマージ競合を解決する。モジュールが競合する属性 (例：一貫性のない maxSdkVersion 値) を宣言している場合、AndroidManifest.xml で tools 名前空間を使用して上書きします。

   <manifest xmlns:android="http://schemas.android.com/apk/res/android"
       xmlns:tools="http://schemas.android.com/tools">
   
       <!-- 例：SDK によって宣言されたが、アプリでは不要な権限を削除します。 -->
       <uses-permission
           android:name="android.permission.BLUETOOTH_CONNECT"
           tools:node="remove" />
   
       <!-- 例：権限属性を上書きします。 -->
       <uses-permission
           android:name="android.permission.BLUETOOTH"
           android:maxSdkVersion="30"
           tools:replace="android:maxSdkVersion" />
   </manifest>

ARTC SDK がサポートする音声コーデックは何ですか？

ARTC SDK は、WebRTC オーディオ処理パイプラインから継承した Opus をデフォルトの音声コーデックとして使用します。

Opus は、オープンでロイヤリティフリーのコーデック (RFC 6716) であり、6～510 kbps の低レイテンシーで高品質な音声を提供します。ARTC SDK は、以下の目的で Opus を使用します。

• 1対1 および複数人通話のためのリアルタイム音声エンコーディングとデコーディング。

• ネットワーク状況に応じたアダプティブビットレート。

• 組み込みのノイズ抑制と自動ゲイン制御 (AGC)。