ApsaraVideo MediaBox SDK for Android のクイック統合 - Apsara Video SDK

このガイドでは、ApsaraVideo MediaBox SDK for Android をクイックに統合する方法について説明します。

重要

SDK v6.6.0 以前から v6.7.0 以降にアップグレードする場合は、「ApsaraVideo MediaBox SDK V6.7.0 の統合レタッチ効果に関する更新」をご参照ください。

動作環境

項目	説明
開発ツール	Android Studio の使用を推奨します。ダウンロード URL： Android Studio。
Android バージョン	Android 5.0 (API レベル 21) 以降。

ステップ 1: SDK の統合

Maven を使用した統合 (推奨)

プロジェクトレベルの build.gradle ファイルに、Maven リポジトリの URL を追加します。
```
maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }
```

アプリの build.gradle ファイルを変更し、SDK の依存関係を dependencies ノードに追加します。

表示されている SDK のバージョンは参考用です。最新バージョンについては、「SDK の選択とダウンロード」をご参照ください。

// ビジネス要件に応じて、次の 4 つのシナリオベースの SDK のいずれかを選択します。

// 1. オールインワン SDK： 再生、リアルタイムストリーミング、標準ライブストリーミング、ショートビデオ、RTC 連携ストリーミング、基本的なレタッチが含まれます。
implementation 'com.aliyun.aio:AliVCSDK_Standard:7.11.0'
// 2. 基本ライブストリーミング SDK： 再生、ライブストリームのアップストリーミング、基本的なレタッチ、リアルタイムストリーミングが含まれます。
implementation 'com.aliyun.aio:AliVCSDK_BasicLive:7.11.0'
// 3. ショートビデオ SDK： 再生、ショートビデオ、基本的なレタッチが含まれます。
implementation 'com.aliyun.aio:AliVCSDK_UGC:7.11.0'
// 4. インタラクティブストリーミング SDK： 再生、リアルタイムストリーミング、ライブストリームのアップストリーミング、RTC 連携ストリーミング、基本的なレタッチが含まれます。
implementation 'com.aliyun.aio:AliVCSDK_InteractiveLive:7.11.0'

手動統合

Android 用のシナリオベースの SDK をダウンロードします。
SDK の .aar ファイルをアプリモジュールの libs ディレクトリにコピーします。
プロジェクトの build.gradle ファイルを変更し、allprojects ブロック内の repositories ノードに flatDir 構成を追加します。
```
flatDir {
   dirs 'libs'
}
```
アプリの build.gradle ファイルを修正し、dependencies ブロックに、AAR への参照を追加します。
```
dependencies {
      implementation fileTree(dir: 'libs', include: ['*.aar'])
}
```

ステップ 2: SDK ライセンスの設定

初めて統合する場合は、ライセンスを購入し、アプリケーションにバインドする必要があります。

ステップ 3: アプリ権限の設定

アプリの src/main/AndroidManifest.xml ファイルで、必要なアプリ権限を設定します。

<!-- ショートビデオの権限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.FLASHLIGHT" />
<uses-permission android:name="android.permission.RECORD_VIDEO" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<!-- 標準ライブストリーミングの権限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.REORDER_TASKS" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />  <!-- マイク権限を追加-->
<uses-permission android:name="android.permission.CAMERA" />  <!-- カメラ権限を追加-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

ステップ 4: 難読化ルールの設定

アプリの proguard-rules.pro ファイルに、次の難読化ルールを追加します。

###################### 再生の難読化ルール #########################
-keep class com.alivc.**{*;}
-keep class com.aliyun.**{*;}
-keep class com.cicada.**{*;}
-dontwarn com.alivc.**
-dontwarn com.aliyun.**
-dontwarn com.cicada.**

###################### ショートビデオの難読化ルール #########################
-keep class com.aliyun.**{*;}
-keep class com.duanqu.**{*;}
-keep class com.qu.**{*;}
-keep class com.alibaba.**{*;}
-keep class component.alivc.**{*;}
-keep class com.alivc.**{*;}
-keep class org.webrtc.**{*;}
-keep class org.ugsv.**{*;}

###################### 標準ライブストリーミングの難読化ルール #########################
-keep class com.alivc.** { *;}
-keep class com.aliyun.rts.network.* { *;}
-keep class org.webrtc.ali.** {*;}
-keep class org.webrtc.utils.** {*;}

よくある質問

機能に関するご質問は、「よくある質問」をご参照ください。