Integrasi cepat SDK ApsaraVideo MediaBox untuk Android - Apsara Video SDK

Panduan ini menjelaskan cara mengintegrasikan SDK ApsaraVideo MediaBox untuk Android secara cepat.

Penting

Jika Anda melakukan upgrade dari SDK v6.6.0 atau versi sebelumnya ke v6.7.0 atau versi setelahnya, lihat Pembaruan efek retouching terintegrasi pada ApsaraVideo MediaBox SDK V6.7.0.

Kebutuhan lingkungan

Item	Deskripsi
Development tool	Kami menyarankan Anda menggunakan Android Studio. URL unduh: Android Studio.
Android version	Android 5.0 (API level 21) atau versi yang lebih baru.

Langkah 1: Integrasikan SDK

Integrasikan menggunakan Maven (disarankan)

Pada file build.gradle tingkat proyek, tambahkan URL repositori Maven.

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

Ubah file build.gradle aplikasi dan tambahkan dependensi SDK ke node dependencies.

Versi SDK yang ditampilkan hanya sebagai referensi. Untuk versi terbaru, lihat Pilih dan unduh SDK.

// Pilih salah satu dari empat SDK berbasis skenario berikut sesuai kebutuhan bisnis Anda.

// 1. SDK all-in-one: Menyertakan pemutaran, real-time streaming, live streaming standar, video pendek, co-streaming RTC, dan retouching dasar.
implementation 'com.aliyun.aio:AliVCSDK_Standard:7.11.0'
// 2. SDK live streaming dasar: Menyertakan pemutaran, stream ingest langsung, retouching dasar, dan real-time streaming.
implementation 'com.aliyun.aio:AliVCSDK_BasicLive:7.11.0'
// 3. SDK video pendek: Menyertakan pemutaran, video pendek, dan retouching dasar.
implementation 'com.aliyun.aio:AliVCSDK_UGC:7.11.0'
// 4. SDK interactive streaming: Menyertakan pemutaran, real-time streaming, stream ingest langsung, co-streaming RTC, dan retouching dasar.
implementation 'com.aliyun.aio:AliVCSDK_InteractiveLive:7.11.0'

Integrasi manual

Unduh SDK berbasis skenario untuk Android.
Salin file .aar SDK ke direktori libs modul aplikasi Anda.
Ubah file build.gradle proyek dan tambahkan konfigurasi flatDir ke node repositories dalam blok allprojects.
```
flatDir {
   dirs 'libs'
}
```
Ubah file build.gradle aplikasi, lalu pada blok dependencies, tambahkan referensi ke file AAR tersebut.
```
dependencies {
      implementation fileTree(dir: 'libs', include: ['*.aar'])
}
```

Langkah 2: Konfigurasikan lisensi SDK

Untuk integrasi pertama kali, Anda harus membeli lisensi dan mengikatnya ke aplikasi Anda.

Langkah 3: Konfigurasikan izin aplikasi

Pada file src/main/AndroidManifest.xml aplikasi, konfigurasikan izin aplikasi yang diperlukan.

<!-- Permissions for short video -->
<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" />

<!-- Permissions for standard live streaming -->
<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" />  <!-- Add the microphone permission-->
<uses-permission android:name="android.permission.CAMERA" />  <!-- Add the camera permission-->
<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" />

Langkah 4: Konfigurasikan aturan obfuscation

Pada file proguard-rules.pro aplikasi, tambahkan aturan obfuscation berikut.

###################### Obfuscation rules for playback #########################
-keep class com.alivc.**{*;}
-keep class com.aliyun.**{*;}
-keep class com.cicada.**{*;}
-dontwarn com.alivc.**
-dontwarn com.aliyun.**
-dontwarn com.cicada.**

###################### Obfuscation rules for short video #########################
-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.**{*;}

###################### Obfuscation rules for standard live streaming #########################
-keep class com.alivc.** { *;}
-keep class com.aliyun.rts.network.* { *;}
-keep class org.webrtc.ali.** {*;}
-keep class org.webrtc.utils.** {*;}

FAQ

Untuk pertanyaan spesifik terkait fitur, lihat FAQ.