Tous les produits
Search
Centre de documentation

ApsaraVideo VOD:Intégrer le SDK Short Video pour Android

Dernière mise à jour :Aug 10, 2026

Intégrez le SDK Short Video pour Android à l'aide de Maven.

Prérequis

Votre environnement de développement doit satisfaire les exigences suivantes :

Élément

Exigence

Version d'Android

4.3 ou ultérieure.

Version de Java

1,7 ou ultérieure.

Niveau d'API Android

18 ou ultérieur.

Version d'Android Studio

2,3 ou ultérieure. Télécharger Android Studio

Intégrer le SDK via Maven (recommandé)

  1. Ajoutez le dépôt Maven d'Alibaba Cloud.

    Insérez l'URL du dépôt Maven d'Alibaba Cloud dans le fichier build.gradle de votre projet.

    allprojects {
        repositories {
            maven {
                url 'https://maven.aliyun.com/nexus/content/repositories/releases/'
           }
        }
    }
  2. Ajoutez les dépendances au fichier build.gradle de votre module d'application :

    Important

    Le SDK Short Video V3.24.0 et les versions ultérieures nécessitent AlivcFFmpeg V4.3.0 ou une version supérieure.

    V7.0.0 ou ultérieure

    dependencies{
        implementation 'com.aliyun.aio:AliVCSDK_ShortVideo:7.11.0'// Required dependency for the Short Video SDK.
        implementation 'com.google.code.gson:gson:2.8.0'// Third-party dependency.
        implementation 'com.aliyun.video.android:upload:1.6.7' // Optional: The upload library. You can omit this if you do not need the upload feature.
        implementation 'com.aliyun.dpa:oss-android-sdk:+'// Optional: The upload SDK and OSS are required for video uploads. You can omit this dependency if you do not need the upload feature.
    }

    V6.21.0 ou antérieure

    dependencies{
      implementation 'com.aliyun.video.android:svideopro:6.21.0'// Required for Professional Edition
      implementation 'com.aliyun.video.android:svideostandard:6.21.0'// Required for Standard Edition
      implementation 'com.aliyun.video.android:svideosnap:6.1.0'// Required for Basic Edition
       // Other dependencies.
      implementation 'com.aliyun.video.android:AlivcFFmpeg:4.3.6'
      implementation 'com.google.code.gson:gson:2.8.0'    // The third-party dependency. 
     }
Remarque

Le SDK Short Video prend uniquement en charge les architectures armeabi-v7a et arm64-v8a. Pour assurer la compatibilité avec armeabi, copiez les fichiers .so armeabi-v7a dans le dossier armeabi. Les appareils ARMv5 et ARMv6 sont obsolètes et ne sont pas pris en charge.

Configurer les permissions

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

Android 6.0 et les versions ultérieures exigent une demande dynamique des permissions.

Configurer votre licence

Configurez votre fichier de licence après l'avoir obtenu. Pour savoir comment procéder, consultez la rubrique Obtenir une licence pour le SDK Short Video.

Ajoutez deux éléments <meta-data> à votre fichier AndroidManifest.xml : com.aliyun.alivc_license.licensekey pour la clé de licence et com.aliyun.alivc_license.licensefile pour le chemin d'accès au fichier de licence.

<application
   android:icon="@drawable/icon"
   android:label="@string/app_name" >
    <meta-data
         android:name="com.aliyun.alivc_license.licensekey"
         android:value="yourLicenseKey"/> // Enter your license key.
    <meta-data
       android:name="com.aliyun.alivc_license.licensefile"
       android:value="yourLicenseFile"/> // Enter the path to the embedded license file. Example: assets/alivc_license/AliVideoCert.crt.
  ...
</application>

Configurer les règles d'obfuscation

Ajoutez les règles d'obfuscation au fichier proguard-rules.pro :

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

Étapes suivantes

Initialiser le SDK Short Video pour Android

Intégration du lecteur

Pour intégrer conjointement le SDK Short Video et le SDK Player, utilisez le SDK ApsaraVideo MediaBox pour Android afin d'éviter les erreurs de classes dupliquées et les échecs de compilation.

Références