本文介紹如何在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:6.18.0' //2.基礎直播SDK:播放器 + 直播推流 + 基礎美顏 + 超低延遲直播 implementation 'com.aliyun.aio:AliVCSDK_BasicLive:6.18.0' //3.短視頻場景SDK:播放器 + 短視頻 + 基礎美顏 implementation 'com.aliyun.aio:AliVCSDK_UGC:6.18.0' //4.互動直播SDK:播放器 + 超低延遲直播 + 直播推流 + RTC連麥 + 基礎美顏 implementation 'com.aliyun.aio:AliVCSDK_InteractiveLive:6.18.0'
手動集成
下載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.** {*;}
常見問題
請參見常見問題下各功能模塊章節。
文檔內容是否對您有幫助?