在Android端快速整合MediaBox音視頻SDK指南 - Apsara Video SDK

本文介紹如何在Android端快速整合MediaBox音視頻SDK。

注意事項

若您需要從v6.6.0及以下版本的SDK升級到v6.7.0（含）以上版本，詳情請參見關於音視頻終端SDK V6.7.0版本美顏特效整合變更公告。

環境要求

類別	說明
開發工具	推薦使用Android Studio，下載地址：Android Studio。
Android版本	支援Android 5.0及以上版本。

步驟一：整合SDK

Maven整合（推薦）

修改專案的build.gradle檔案，添加Maven倉庫地址。

maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }

修改App的build.gradle檔案，在dependencies節點中添加SDK依賴。

本文中引入的SDK版本號碼僅供參考，擷取最新的版本請參見情境SDK。

//下面4種情境組合，請根據自己的業務需要，選擇一種接入即可

//1.標準一體化SDK:播放器 + 超低延遲直播 + 直播 + 短視頻 + RTC連麥 + 基礎美顏
implementation 'com.aliyun.aio:AliVCSDK_Standard:7.9.1'
//2.基礎直播SDK:播放器 + 直播推流 + 基礎美顏 + 超低延遲直播
implementation 'com.aliyun.aio:AliVCSDK_BasicLive:7.9.1'
//3.短視頻情境SDK:播放器 + 短視頻 + 基礎美顏
implementation 'com.aliyun.aio:AliVCSDK_UGC:7.9.1'
//4.互動直播SDK:播放器 + 超低延遲直播 + 直播推流 + RTC連麥 + 基礎美顏
implementation 'com.aliyun.aio:AliVCSDK_InteractiveLive:7.9.1'

手動整合

下載Android端指定情境SDK。
複製SDK檔案*.aar到App模組下的libs檔案夾。
修改專案的build.gradle檔案，在allprojects的repositories節點中增加flatDir配置。
```
flatDir {
   dirs 'libs'
}
```

修改App的build.gradle檔案，在dependencies節點中增加aar的引用。

dependencies {
      implementation fileTree(dir: 'libs', include: ['*.aar'])
}

步驟二：配置License授權

首次接入SDK，需要管理License並配置License授權。

步驟三：配置App許可權

修改App的src/main/AndroidManifest.xml檔案，配置App許可權。

<!-- 短視頻許可權配置-->
<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" />

步驟四：配置混淆規則

修改App的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.** {*;}

常見問題

請參見常見問題下各功能模組章節。