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
-
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" } -
Ajoutez la dépendance du SDK au bloc
dependenciesdu fichier build.gradle du module app.// Push SDK basic edition implementation 'com.alivc.pusher:AlivcLivePusher:x.y.z'Remarquex.y.zindique 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.
-
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
Téléchargez et décompressez le package du SDK Push pour Android.
Copiez le fichier AAR dans le dossier libs du module app.
-
Dans le fichier build.gradle du projet, ajoutez la configuration
flatDirdans la sectionrepositoriesdu blocallprojects.flatDir { dirs 'libs' } -
Ajoutez la référence au fichier AAR dans le bloc
dependenciesdu 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
Pour obtenir des informations détaillées sur l'API, consultez API reference for Push SDK for Android (basic edition).
Pour consulter des exemples de code illustrant l'utilisation des fonctionnalités du SDK, reportez-vous à Utiliser le SDK Push pour Android.