Tous les produits
Search
Centre de documentation

ApsaraVideo Live:Intégration du SDK

Dernière mise à jour :Aug 19, 2026

Cette rubrique explique comment intégrer le SDK Push pour Android.

Prérequis

Élément

Description

Outil de développement

Nous vous recommandons d'utiliser Android Studio.

Version Android

Android 5.0 ou version ultérieure est requis.

Étape 1 : Intégrer le SDK Push pour Android

(Recommandé) Intégrer le SDK via Maven

  1. Spécifiez l'URL du dépôt Maven dans le fichier build.gradle du projet.

    maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }
  2. Ajoutez la dépendance du SDK au bloc dependencies du fichier build.gradle du module app.

    // Push SDK basic edition
    implementation 'com.alivc.pusher:AlivcLivePusher:x.y.z'
    Remarque
    • x.y.z indique le numéro de version du SDK Push pour Android. Remplacez-le par le numéro de version réel, par exemple 7.4.0. Pour connaître le dernier numéro de version, consultez Téléchargement du SDK.

    • Vous ne pouvez pas intégrer simultanément le SDK Push et le SDK Player (AliyunPlayer). Si vous souhaitez intégrer les deux SDK, utilisez plutôt le SDK ApsaraVideo MediaBox. Pour plus d'informations, consultez Télécharger les SDK tout-en-un et Intégration rapide.

  3. Spécifiez l'architecture CPU de votre application dans le fichier build.gradle du module app.

    defaultConfig {
     ndk {
     abiFilters "armeabi", "armeabi-v7a", "arm64-v8a"
     }
    }

Intégrer manuellement le SDK

  1. Téléchargez et décompressez le package du SDK Push pour Android.

  2. Copiez le fichier AAR dans le dossier libs du module app.

  3. Dans le fichier build.gradle du projet, ajoutez la configuration flatDir dans la section repositories du bloc allprojects.

    flatDir {
     dirs 'libs'
    }
  4. Ajoutez la référence au fichier AAR dans le bloc dependencies du fichier build.gradle du module app.

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

Étape 2 : Configurer une licence

Pour savoir comment configurer une licence pour le SDK, consultez Intégrer une licence du SDK Push.

Étape 3 : Configurer les permissions de l'application

Configurez les permissions requises dans le fichier src/main/AndroidManifest.xml du module app.

<!--  Used for network features  -->
<uses-permission android:name="android.permission.INTERNET" />
<!--  To check the network connection state of the device, you'll need to add the ACCESS_NETWORK_STATE permission.  -->
<!--  This permission does not require user consent at runtime, but needs to be declared in the app's AndroidManifest.xml.  -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<!--  If the app needs to record audio, you need to declare the RECORD_AUDIO permission and request this permission at runtime  -->
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

<!--  The application needs to access the device's camera  -->
<uses-permission android:name="android.permission.CAMERA" />

<!-- Request legacy Bluetooth permissions on older devices. -->
<uses-permission
  android:name="android.permission.BLUETOOTH"
  android:maxSdkVersion="30" />
<uses-permission
  android:name="android.permission.BLUETOOTH_ADMIN"
  android:maxSdkVersion="30" />
<!-- Needed only if your app communicates with already-paired Bluetooth devices. -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

<!-- Only used by Demo for accessing storage files  -->
<!--  Storage permissions  -->
<uses-permission
  android:name="android.permission.READ_EXTERNAL_STORAGE"
  android:maxSdkVersion="32" />
<!-- Access image files -->
<uses-permission
  android:name="android.permission.READ_MEDIA_IMAGES"
  android:minSdkVersion="33" />
<!-- Write audio files -->
<uses-permission
  android:name="android.permission.READ_MEDIA_AUDIO"
  android:minSdkVersion="33" />
<!-- Write video files -->
<uses-permission
  android:name="android.permission.READ_MEDIA_VIDEO"
  android:minSdkVersion="33" />

<!-- Only used by Demo for screen recording and streaming  -->
<!-- Used for creating background tasks, not required by SDK -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<!-- Requesting permission to create system overlay windows -->
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

<!-- Only used by Demo for muting  -->
<!-- If this permission is not declared, the feature of automatically muting the stream during a phone call will not work -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

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

Ajoutez des règles d'obfuscation au fichier proguard-rules.pro du module app.

-keep class org.webrtc.** { *; }
-keep class com.alivc.** { *; }
-keep class com.aliyun.** { *; }
-keep class com.cicada.** { *; }

Notes d'utilisation