ApsaraVideo Live:ARTC SDK のダウンロードと統合

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

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // ARTC SDK の Maven リポジトリを追加
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
}

allprojects {
    repositories {
        ...
        // ARTC SDK の Maven リポジトリを追加
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
}

dependencies {
    // ARTC SDK の依存関係を追加
    // ${latest_version} を具体的なバージョン番号に置き換えます。
    implementation 'com.aliyun.aio:AliVCSDK_ARTC:${latest_version}'
    // バージョン 7.4.0 以前の場合、keep 依存関係を追加
    // implementation 'com.aliyun.aio.keep:keep:1.0.1'
}   

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // ARTC SDK が配置されている相対ディレクトリを追加
        flatDir {
            dir 'app/libs'
        }
    }
}

allprojects {
    repositories {
        ...
        // ARTC SDK が配置されている相対ディレクトリを追加
        flatDir {
            dir 'app/libs'
        }
    }
}

// x.y.z を具体的なバージョン番号に置き換えます。
implementation(name:'AliVCSDK_ARTC', version: 'x.y.z', ext:'aar')

ステップ 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：権限の構成

アプリケーションに必要な権限を構成します。

app/src/main ディレクトリに移動し、AndroidManifest.xml ファイルを開いて必要な権限を追加します。

<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+ 向けの新しい権限を上書きして削除 -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

<!-- 従来の Bluetooth 権限を宣言し、古いデバイス向けに maxSdkVersion を設定 -->
<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：コード難読化の防止（任意）

app/proguard-rules.pro ファイルで SDK のルールを構成し、SDK が提供するインターフェイスが難読化されて関数呼び出しが正常に行われなくなることを防ぎます。

-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.** {
*;
}

ARTC SDK は追加の権限を追加しますか？

はい。ARTC SDK をインポートすると、アプリのマニフェストに自動的に以下の Android 権限が追加されます。正確なリストは SDK バージョンによって異なる場合があります。確定的なリストについては、.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 バージョンの互換性を処理する内部ロジック（例：Android 12+ での BLUETOOTH_CONNECT のランタイム権限要求）が含まれていますが、特定のシナリオでは問題が発生する可能性があります。

• ランタイムの問題：ビルドプロセス中にマニフェストのマージに失敗するなど、予期しない動作が発生する可能性があります。

• Google Play 審査のリスク：アプリが使用していない機能（例：Bluetooth）の権限を宣言している場合、最小権限の原則に違反し、Play ストアからアプリが拒否される可能性があります。

これらの問題を解決するには、以下の手順を推奨します。

1. 権限の必要性を評価
   まず、アプリが SDK によって宣言されたすべての権限を必要とするかどうかを評価します。機能（例：Bluetooth）を使用しない場合は、その権限宣言を削除します。たとえば、アプリの targetSdkVersion が 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>
   

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

sudo gem install cocoapods

pod init

target 'MyApp' do
  use_frameworks!
  # ${latest version} を具体的なバージョン番号に置き換えます。
  pod 'AliVCSDK_ARTC', '~> ${latest version}'
end

pod install

ステップ 2：権限の構成

• 録画およびカメラ権限を追加する必要があります。

Info.plist ファイルにカメラおよびマイク権限の Privacy - Camera Usage Description および Privacy - Microphone Usage Description を追加します。

• オーディオのバックグラウンドモードを有効化（任意）。

図に示すように、Audio, AirPlay, and Picture in Picture をチェックします。