全部产品
Search
文档中心

ApsaraVideo VOD:Integrasikan SDK

更新时间:Jan 29, 2026

Topik ini menjelaskan cara mengintegrasikan SDK video pendek untuk Android menggunakan Maven.

Prasyarat

Tabel berikut menjelaskan lingkungan pengembangan yang diperlukan.

Kategori

Deskripsi

Versi sistem

Mendukung Android 4.3 dan versi yang lebih baru.

Versi Java

Mendukung Java 1.7 dan versi yang lebih baru.

API level

Mendukung Android SDK API level 18 dan versi yang lebih baru.

Versi Android Studio

Mendukung Android Studio 2.3 dan versi yang lebih baru. Unduh Android Studio.

Integrasikan menggunakan Maven (Direkomendasikan)

  1. Tambahkan repositori Maven Alibaba Cloud.

    Tambahkan URL repositori Maven ke file build.gradle tingkat proyek.

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

    Penting

    Jika Anda menggunakan SDK video pendek V3.24.0 atau yang lebih baru, Anda harus menggunakan FFmpeg V4.3.0 atau yang lebih baru.

    Integrasi untuk V7.0.0 dan yang lebih baru

    dependencies{
        implementation 'com.aliyun.aio:AliVCSDK_ShortVideo:7.10.0'// Dependensi wajib untuk SDK video pendek.
        implementation 'com.google.code.gson:gson:2.8.0'// Library dependensi pihak ketiga.
        implementation 'com.aliyun.video.android:upload:1.6.7' // Library unggah. Ini opsional jika Anda tidak memerlukan fitur unggah.
        implementation 'com.aliyun.dpa:oss-android-sdk:+'// Fitur unggah video pendek memerlukan unggah SDK dan OSS. Ini opsional jika Anda tidak memerlukan fitur unggah.
    }

    Integrasi untuk V6.21.0 dan yang lebih lama

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

SDK video pendek saat ini hanya menyediakan file .so untuk set instruksi armeabi-v7a dan arm64-v8a. Jika Anda memerlukan dukungan untuk set instruksi armeabi, salin file .so dari direktori armeabi-v7a ke direktori armeabi. Catatan: SDK video pendek mendukung Android 4.3 dan versi yang lebih baru, sehingga kompatibilitas dengan perangkat ARMv5 dan ARMv6 yang lebih lama tidak dijamin.

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

Untuk Android 6.0 dan versi yang lebih baru, Anda harus meminta izin secara dinamis.

Konfigurasikan lisensi

Setelah memperoleh lisensi, konfigurasikan file lisensi sebagai berikut. Untuk informasi selengkapnya tentang cara mendapatkan lisensi, lihat Dapatkan lisensi untuk SDK video pendek.

Dalam file AndroidManifest.xml, tambahkan dua elemen meta-data. Untuk elemen pertama, atur nama kunci menjadi com.aliyun.alivc_license.licensekey dan nilai menjadi LicenseKey Anda. Untuk elemen kedua, atur nama kunci menjadi com.aliyun.alivc_license.licensefile dan nilai menjadi path ke file sertifikat bawaan. Nama kunci harus menggunakan huruf kecil semua. Kode berikut memberikan contoh:

<application
   android:icon="@drawable/icon"
   android:label="@string/app_name" >
    <meta-data
         android:name="com.aliyun.alivc_license.licensekey"
         android:value="yourLicenseKey"/> // Masukkan LicenseKey Anda.
    <meta-data
       android:name="com.aliyun.alivc_license.licensefile"
       android:value="yourLicenseFile"/> // Masukkan path file sertifikat bawaan Anda. Contoh: assets/alivc_license/AliVideoCert.crt
  ……
</application>

Konfigurasi obfuscation

Anda dapat mengonfigurasi obfuscation dalam file proguard-rules.pro. Kode berikut memberikan contoh:

###################### Konfigurasi obfuscation untuk SDK video pendek #########################
-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 Selanjutnya

Inisialisasi SDK

Integrasi Player

Untuk mengintegrasikan SDK video pendek dan SDK player untuk Android ke dalam proyek Anda, gunakan SDK all-in-one untuk Android guna mencegah masalah kelas duplikat yang dapat menyebabkan kegagalan kompilasi.

Referensi