Panduan integrasi cepat SDK MediaBox untuk audio dan video di Android - Apsara Video SDK

Topik ini menjelaskan cara mengintegrasikan SDK MediaBox untuk audio dan video di Android secara cepat.

Catatan penggunaan

Untuk melakukan upgrade dari SDK v6.6.0 atau versi sebelumnya ke v6.7.0 atau versi setelahnya, lihat Pengumuman perubahan integrasi efek retouching pada Media SDK untuk audio dan video V6.7.0.

Persyaratan lingkungan

Kategori	Deskripsi
Development tool	Disarankan menggunakan Android Studio. Unduh dari website Android Studio.
Android version	Android 5.0 atau versi yang lebih baru.

Langkah 1: Integrasi SDK

Integrasi Maven (Direkomendasikan)

Ubah file build.gradle proyek untuk menambahkan alamat repositori Maven.

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

Ubah file build.gradle aplikasi untuk menambahkan dependensi SDK pada node dependencies.

Nomor versi SDK dalam topik ini hanya sebagai referensi. Untuk mendapatkan versi terbaru, lihat SDK berdasarkan skenario.

// Pilih salah satu dari empat SDK berikut sesuai kebutuhan.

// 1. All-in-one SDK: Player + Real-Time Streaming (RTS) + Live + Short Video + RTC Co-streaming + Basic Retouching
implementation 'com.aliyun.aio:AliVCSDK_Standard:7.10.0'
// 2. Basic Live SDK: Player + Stream Ingest + Basic Retouching + RTS
implementation 'com.aliyun.aio:AliVCSDK_BasicLive:7.10.0'
// 3. Short Video SDK: Player + Short Video + Basic Retouching
implementation 'com.aliyun.aio:AliVCSDK_UGC:7.10.0'
// 4. Interactive Live SDK: Player + RTS + Stream Ingest + RTC Co-streaming + Basic Retouching
implementation 'com.aliyun.aio:AliVCSDK_InteractiveLive:7.10.0'

Integrasi manual

Unduh SDK berdasarkan skenario yang diperlukan untuk Android.
Salin file SDK *.aar ke folder libs di modul aplikasi Anda.
Ubah file build.gradle proyek untuk menambahkan konfigurasi flatDir ke node repositories dalam allprojects.
```
flatDir {
   dirs 'libs'
}
```

Ubah file build.gradle aplikasi untuk menambahkan referensi AAR pada node dependencies.

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

Langkah 2: Konfigurasi otorisasi lisensi

Saat pertama kali mengintegrasikan SDK, Anda harus mengelola lisensi dan mengonfigurasi otorisasi lisensi.

Langkah 3: Konfigurasi izin aplikasi

Ubah file src/main/AndroidManifest.xml aplikasi Anda untuk mengonfigurasi izin aplikasi.

<!-- 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 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 permission for audio recording -->
<uses-permission android:name="android.permission.CAMERA" />  <!-- Add permission for 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" />

Langkah 4: Konfigurasi aturan obfuscation

Ubah file proguard-rules.pro aplikasi untuk menambahkan aturan obfuscation.

###################### Obfuscation rules for Player #########################
-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 Live Streaming #########################
-keep class com.alivc.** { *;}
-keep class com.aliyun.rts.network.* { *;}
-keep class org.webrtc.ali.** {*;}
-keep class org.webrtc.utils.** {*;}

FAQ

Untuk informasi lebih lanjut, lihat bagian masing-masing fitur dalam FAQ.