ApsaraVideo Live:Téléchargement et intégration du SDK

Intégration automatique via Maven (recommandée)

1. Ouvrez le fichier settings.gradle à la racine du projet. Ajoutez le dépôt Maven du SDK ARTC sous dependencyResolutionManagement/repositories :

   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
           mavenCentral()
           // Add the Maven repository for the ARTC SDK.
           maven { url 'https://maven.aliyun.com/repository/google' }
           maven { url 'https://maven.aliyun.com/repository/public' }
       }
   }

   Remarque

   Si votre version d'Android Gradle Plugin (AGP) est inférieure à 7.1.0, le fichier settings.gradle peut ne pas contenir le bloc dependencyResolutionManagement, comme indiqué dans les Notes de publication d'Android Gradle Plugin 7.1. Utilisez plutôt l'approche suivante :

   Version AGP inférieure à 7.1.0

   Ouvrez le fichier build.gradle à la racine de votre projet. Ajoutez le dépôt Maven sous allprojects/repositories :

   allprojects {
       repositories {
           ...
           // Add the Maven repository for the ARTC SDK.
           maven { url 'https://maven.aliyun.com/repository/google' }
           maven { url 'https://maven.aliyun.com/repository/public' }
       }
   }

2. Ouvrez le fichier app/build.gradle. Ajoutez la dépendance du SDK ARTC sous dependencies. Remplacez \${latest_version} par le numéro de version réel. La dernière version est la 7.11.0.

   dependencies {
       // Add the ARTC SDK dependency.
       // Replace ${latest_version} with the actual version number.
       implementation 'com.aliyun.aio:AliVCSDK_ARTC:${latest_version}'
       // For version 7.4.0 and earlier, also add the keep dependency.
       // implementation 'com.aliyun.aio.keep:keep:1.0.1'
   }

   Pour AGP 8.1 et versions ultérieures, envisagez de migrer vers les catalogues de versions. Consultez Migrer les dépendances vers les catalogues de versions.

Intégration manuelle par téléchargement du SDK

1. Téléchargez le fichier AAR du SDK ARTC depuis la section de téléchargement du SDK. La dernière version est la 7.11.0. Format du nom de fichier : AliVCSDK_ARTC-x.y.z.aar.

2. Copiez le fichier AAR dans le répertoire de votre projet (par exemple, app/libs). Créez le répertoire si nécessaire.

3. Ouvrez le fichier settings.gradle à la racine du projet. Ajoutez le répertoire du fichier AAR sous dependencyResolutionManagement/repositories :

   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
           mavenCentral()
           // Add the relative path to the ARTC SDK AAR file.
           flatDir {
               dir 'app/libs'
           }
       }
   }

   Pour les versions AGP inférieures à 7.1.0, ajoutez les éléments suivants sous allprojects/repositories dans le fichier build.gradle :

   allprojects {
       repositories {
           ...
           // Add the relative path to the ARTC SDK AAR file.
           flatDir {
               dir 'app/libs'
           }
       }
   }

4. Ouvrez le fichier app/build.gradle. Ajoutez la dépendance AAR sous dependencies :

   // Replace x.y.z with the actual version number.
   implementation(name:'AliVCSDK_ARTC', version: 'x.y.z', ext:'aar')

5. Après la compilation, la dépendance apparaît sous External Libraries.

   External Libraries
     > < Android API 35, extension level 13 Platform > /Users/wy/Libra...
     > < jbr-21 > /Applications/Android Studio.app/Contents/jbr/Conte...
     > Gradle: :AliVCSDK_ARTC:7.2.0@aar
     > Gradle: androidx.activity:activity:1.8.0@aar

android {
    defaultConfig {
        // ...other default configurations
        // Support armeabi-v7a and arm64-v8a architectures.
        ndk {
             abiFilters "armeabi-v7a", "arm64-v8a"
        }
    }
}

<uses-feature android:name="android.hardware.camera" android:required="false" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- 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" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WRITE_SETTINGS"
  tools:ignore="ProtectedPermissions" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

Demander dynamiquement les permissions Bluetooth

Le SDK ARTC intègre ces permissions dans son fichier AndroidManifest.xml. À partir d'Android 12, la permission BLUETOOTH_CONNECT nécessite une demande au moment de l'exécution :

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

Si votre application n'a pas besoin de Bluetooth, supprimez la déclaration du fichier AndroidManifest.xml :

<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove"/>

<!-- Declare Bluetooth permission. -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<!-- Override removal of high-version API 31+ permission. -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

<!-- Declare Bluetooth permission with android:maxSdkVersion set to 30 for backward compatibility. -->
<uses-permission android:name="android.permission.BLUETOOTH"/>
<!-- Declare high-version API 31+ Bluetooth permission. -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>
<!-- Other Bluetooth permissions. -->

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    String[] permissions = {
        android.Manifest.permission.BLUETOOTH_CONNECT
    };
    ActivityCompat.requestPermissions(activity, permissions, REQUEST_BLUETOOTH);
}

<!-- Override and remove built-in Bluetooth permission declarations from the ARTC SDK. -->
<uses-permission android:name="android.permission.BLUETOOTH" tools:node="remove" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

Autres permissions dynamiques

À partir d'Android 6.0 (API 23), ces permissions nécessitent également des demandes au moment de l'exécution, au-delà des déclarations dans le fichier AndroidManifest.xml :

• Manifest.permission.CAMERA

• Manifest.permission.WRITE_EXTERNAL_STORAGE

• Manifest.permission.RECORD_AUDIO

• Manifest.permission.READ_EXTERNAL_STORAGE

• Manifest.permission.READ_PHONE_STATE

Pour Android 12 (API 31) et versions ultérieures, demandez également cette permission au moment de l'exécution :

• Manifest.permission.BLUETOOTH_CONNECT

-keep class com.aliyun.allinone.** {
*;
}

-keep class com.aliyun.rts.network.AliHttpTool {
*;
}

-keep class com.aliyun.common.AlivcBase {
*;
}

-keep class com.huawei.multimedia.alivc.** {
*;
}

-keep class com.alivc.rtc.** {
*;
}

-keep class com.alivc.component.** {
*;
}

-keep class org.webrtc.** {
*;
}

Intégration automatique via CocoaPods (recommandée)

1. Installez CocoaPods s'il n'est pas déjà installé :

   sudo gem install cocoapods

2. Accédez à la racine du projet et créez un Podfile :

   pod init

3. Ouvrez le fichier Podfile et ajoutez la dépendance du SDK ARTC. La dernière version est la 7.11.0.

   target 'MyApp' do
     use_frameworks!
     # Replace ${latest version} with the actual version number.
     pod 'AliVCSDK_ARTC', '~> ${latest version}'
   end

4. Installez les dépendances :

   pod install

5. Un fichier .xcworkspace est généré. Ouvrez-le pour lancer le projet dans Xcode.

Après avoir ouvert le projet, développez le dossier Pods dans le navigateur de projet Xcode à gauche. Confirmez qu'il contient le sous-dossier AliVCSDK_ARTC, ce qui indique que la dépendance du SDK a été intégrée avec succès.

Intégration manuelle par téléchargement du SDK

1. Téléchargez et extrayez la dernière version du SDK ARTC depuis la section de téléchargement du SDK.

2. Copiez le fichier framework du SDK extrait vers le répertoire de votre projet.

3. Ouvrez votre projet dans Xcode. Sélectionnez File > Add Files to "xxx" pour ajouter le fichier de bibliothèque du SDK au projet.

4. Sélectionnez la cible et définissez l'attribut du framework importé. Dans la section Frameworks, Libraries, and Embedded Content, confirmez que la colonne Embed pour alivcffmpeg.framework et AliVCSDK_ARTC.framework est définie sur Do Not Embed.

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />