Intégration rapide du SDK ApsaraVideo MediaBox pour Android - Apsara Video SDK

Important

Si vous effectuez une mise à niveau du SDK v6.6.0 ou antérieur vers la version v6.7.0 ou ultérieure, consultez les Mises à jour des effets de retouche intégrés du SDK ApsaraVideo MediaBox V6.7.0.

Prérequis environnementaux

Élément

Description

Outil de développement

Android Studio (recommandé).

Version d'Android

Android 5.0 (niveau d'API 21) ou version ultérieure.

Étape 1 : Intégrer le SDK

Intégration via Maven (recommandée)

Dans le fichier build.gradle au niveau du projet, ajoutez l'URL du dépôt Maven.
```
maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }
```

Dans le fichier build.gradle au niveau de l'application, ajoutez la dépendance du SDK au nœud dependencies.

La version indiquée est fournie à titre indicatif uniquement. Récupérez la dernière version depuis la rubrique Sélectionner et télécharger les SDK.

// Choose one of the following four scenario-based SDKs based on your business requirements.

// 1. All-in-one SDK: Includes playback, real-time streaming, standard live streaming, short video, RTC co-streaming, and basic retouching.
implementation 'com.aliyun.aio:AliVCSDK_Standard:7.11.0'
// 2. Basic live streaming SDK: Includes playback, live stream ingest, basic retouching, and real-time streaming.
implementation 'com.aliyun.aio:AliVCSDK_BasicLive:7.11.0'
// 3. Short video SDK: Includes playback, short video, and basic retouching.
implementation 'com.aliyun.aio:AliVCSDK_UGC:7.11.0'
// 4. Interactive streaming SDK: Includes playback, real-time streaming, live stream ingest, RTC co-streaming, and basic retouching.
implementation 'com.aliyun.aio:AliVCSDK_InteractiveLive:7.11.0'

Intégration manuelle

Téléchargez un SDK basé sur des scénarios pour Android.
Copiez le fichier .aar du SDK dans le répertoire libs de votre module d'application.
Dans le fichier build.gradle au niveau du projet, ajoutez la configuration flatDir au nœud repositories sous le bloc allprojects.
```
flatDir {
   dirs 'libs'
}
```
Dans le fichier build.gradle au niveau de l'application, ajoutez la référence AAR au bloc dependencies.
```
dependencies {
      implementation fileTree(dir: 'libs', include: ['*.aar'])
}
```

Étape 2 : Configurer la licence du SDK

Avant votre première intégration, achetez une licence et associez-la à votre application.

Étape 3 : Configurer les permissions de l'application

Ajoutez les permissions requises à votre fichier src/main/AndroidManifest.xml.

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

Étape 4 : Configurer les règles d'obfuscation

Ajoutez les règles suivantes à votre fichier proguard-rules.pro.

###################### 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

La section FAQ traite des questions spécifiques aux fonctionnalités.