All Products
Search
Document Center

ApsaraVideo VOD:Integrasikan SDK

Last Updated:Apr 23, 2026

Topik ini menjelaskan cara mengintegrasikan Short Video SDK untuk Android menggunakan Maven.

Prasyarat

Pastikan persyaratan lingkungan berikut terpenuhi sebelum memulai pengembangan:

Item

Persyaratan

Versi Android

4.3 atau lebih baru.

Versi Java

1.7 atau lebih baru.

Level API Android

18 atau lebih baru.

Versi Android Studio

2.3 atau lebih baru. Unduh Android Studio

(Disarankan) Integrasikan SDK menggunakan Maven

  1. Tambahkan repositori Maven Alibaba Cloud.

    Tambahkan URL repositori Maven Alibaba Cloud ke file build.gradle proyek Anda.

    allprojects {
        repositories {
            maven {
                url 'https://maven.aliyun.com/nexus/content/repositories/releases/'
           }
        }
    }
  2. Tambahkan dependensi berikut ke file build.gradle modul aplikasi Anda:

    Penting

    Jika Anda ingin menggunakan Short Video SDK V3.24.0 atau lebih baru, pastikan Anda menggunakan AlivcFFmpeg V4.3.0 atau lebih baru.

    V7.0.0 atau lebih baru

    dependencies{
        implementation 'com.aliyun.aio:AliVCSDK_ShortVideo:7.11.0'// Dependensi wajib untuk Short Video SDK.
        implementation 'com.google.code.gson:gson:2.8.0'// Dependensi pihak ketiga.
        implementation 'com.aliyun.video.android:upload:1.6.7' // Opsional: Library upload. Anda dapat menghilangkan ini jika tidak memerlukan fitur upload.
        implementation 'com.aliyun.dpa:oss-android-sdk:+'// Opsional: SDK upload dan OSS diperlukan untuk upload video. Anda dapat menghilangkan dependensi ini jika tidak memerlukan fitur upload.
    }

    V6.21.0 atau lebih lama

    dependencies{
      implementation 'com.aliyun.video.android:svideopro:6.21.0'// Wajib untuk Edisi Profesional
      implementation 'com.aliyun.video.android:svideostandard:6.21.0'// Wajib untuk Edisi Standar
      implementation 'com.aliyun.video.android:svideosnap:6.1.0'// Wajib untuk Edisi Dasar
       // Dependensi lainnya.
      implementation 'com.aliyun.video.android:AlivcFFmpeg:4.3.6'
      implementation 'com.google.code.gson:gson:2.8.0'    // Dependensi pihak ketiga. 
     }
Catatan

Short Video SDK saat ini hanya mendukung set instruksi armeabi-v7a dan arm64-v8a. Jika Anda memerlukan kompatibilitas armeabi, kami menyarankan agar Anda menyalin file .so armeabi-v7a ke folder armeabi sebagai solusi sementara. Mengingat evolusi Android dan persyaratan minimum Short Video SDK yaitu Android 4.3, dukungan untuk ARMv5 dan ARMv6 tidak diperlukan karena perangkat tersebut sudah usang.

Konfigurasikan izin

<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" />
Catatan

Permintaan izin dinamis diperlukan untuk Android 6.0 atau lebih baru.

Konfigurasikan lisensi Anda

Setelah memperoleh lisensi, Anda perlu mengonfigurasi file lisensi tersebut. Untuk informasi tentang cara memperoleh lisensi, lihat Memperoleh lisensi untuk short video SDK.

Dalam file AndroidManifest.xml Anda, tambahkan dua elemen <meta-data> untuk lisensi Anda. Gunakan com.aliyun.alivc_license.licensekey untuk kunci lisensi Anda dan com.aliyun.alivc_license.licensefile untuk path file lisensi Anda, seperti pada contoh berikut:

<application
   android:icon="@drawable/icon"
   android:label="@string/app_name" >
    <meta-data
         android:name="com.aliyun.alivc_license.licensekey"
         android:value="yourLicenseKey"/> // Masukkan kunci lisensi Anda.
    <meta-data
       android:name="com.aliyun.alivc_license.licensefile"
       android:value="yourLicenseFile"/> // Masukkan path ke file lisensi yang disematkan. Contoh: assets/alivc_license/AliVideoCert.crt.
  ...
</application>

Konfigurasikan aturan obfuscation

Anda dapat mengonfigurasi aturan obfuscation dalam file proguard-rules.pro. Contoh kode:

######################Konfigurasi obfuscation untuk Short Video SDK#########################
-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.**{*;}

Langkah Berikutnya

Inisialisasi Short Video SDK untuk Android

Integrasi Pemutar

Jika Anda perlu mengintegrasikan Short Video SDK dan Player SDK ke dalam proyek Anda, kami menyarankan Anda menggunakan ApsaraVideo MediaBox SDK untuk Android. Solusi terpadu ini mencegah error kelas duplikat dan kegagalan kompilasi.

Referensi