ApsaraVideo VOD:Préparation à l'intégration

Configurez votre environnement de développement

Avant d'utiliser AliPlayerKit, assurez-vous que votre environnement de développement répond aux exigences suivantes :

• JDK 11

  • Configurez le JDK dans Preferences → Build, Execution, Deployment → Build Tools → Gradle → Gradle JDK.

  • Sélectionnez la version 11. Si la version 11 n'est pas disponible, mettez à jour Android Studio.

• Environnement de développement Android

  • Installez la dernière version d'Android Studio.

  • Configurez le SDK Android. Le niveau d'API minimum pris en charge est 21 (Android 5.0).

  • Nous vous recommandons d'utiliser compileSdkVersion 31 ou une version ultérieure.

  • Votre version de Gradle doit être 7,0 ou ultérieure.

Préparez votre licence

Obtenez le certificat de licence et la clé de licence pour le SDK ApsaraVideo Player. Pour plus d'informations, consultez Gérer les licences.

Étape 1 : Copiez le module de composant

Copiez le répertoire du module central playerkit (bibliothèque) dans votre projet :

# Copy the playerkit core module to your project root directory
# Note: Copy only the playerkit directory—not the entire project or example modules such as playerkit-examples or playerkit-scenes
cp -r playerkit /path/to/your/project/

Étape 2 : Configurez votre projet Gradle

repositories {
    // aliyun maven
    maven { url "https://maven.aliyun.com/repository/releases" }
}

repositories {
    // aliyun maven
    maven("https://maven.aliyun.com/repository/releases")
}

include ':playerkit'

include(":playerkit")

dependencies {
    // AliPlayerKit core module: Provides an out-of-the-box, configurable player UI component. Supports basic playback and common interactions.
    implementation project(':playerkit')
}

dependencies {
    // AliPlayerKit core module: Provides an out-of-the-box, configurable player UI component. Supports basic playback and common interactions.
    implementation(project(":playerkit"))
}

Étape 3 : Configurez votre licence

<meta-data
    android:name="com.aliyun.alivc_license.licensekey"
    android:value="Your License Key" />
<meta-data
    android:name="com.aliyun.alivc_license.licensefile"
    android:value="assets/cert/license.crt" />          

Étape 4 : Vérifiez l'intégration

./gradlew clean assemble --stacktrace --info

git add .
git commit -m "feat: integrate AliPlayerKit module (source commit: 2c30d92)"            

Étape 1 : Copiez les modules de scénario

Copiez les modules de scénario requis dans votre projet en fonction de vos besoins métier :

# scene-common includes sample video constants. Skip it if you implement your own video source.
cp -r playerkit-scenes/scene-common /path/to/your/project/

# Choose other scenario modules as needed.
cp -r playerkit-scenes/scene-longvideo /path/to/your/project/
cp -r playerkit-scenes/scene-live /path/to/your/project/
# ...         

Étape 2 (facultative) : Résolvez les dépendances des modules

Les fichiers build.gradle des modules de scénario dépendent de demo-settings et de scene-common. Ajustez ces dépendances en fonction de vos besoins :

dependencies {
    // ...
    // Delete this line: demo-settings is used only for demos.
    // implementation project(':demo-settings')
}          

dependencies {
    // ...
    // Comment out or delete this line if you implement your own video source.
    // implementation project(':scene-common')
}          

// ===== Original code (uses demo-settings / scene-common)=====
import com.aliyun.playerkit.example.settings.link.LinkConstants;
import com.aliyun.playerkit.example.settings.storage.SPManager;
import com.aliyun.playerkit.scenes.common.SceneConstants;

private String getVideoVid() {
    String savedVid = SPManager.getInstance().getString(LinkConstants.KEY_VIDEO_VID);
    return StringUtil.isNotEmpty(savedVid) ? savedVid : SceneConstants.LANDSCAPE_SAMPLE_VID;
}

// ===== Updated (use your video source)=====
private String getVideoVid() {
    return "Your video Vid";  // Or fetch it from your business API.
}

private String getVideoPlayAuth() {
    return "Your PlayAuth";  // Or fetch it from your business API.
}           

Étape 3 : Configurez votre projet Gradle

include ':scene-common'
include ':scene-longvideo'
// Add other scenario modules as needed...

include(":scene-common")
include(":scene-longvideo")
// Add other scenario modules as needed...

dependencies {
    // AliPlayerKit scenario modules: Built on the AliPlayerKit core component. Provide out-of-the-box standard playback solutions.
    // Long-form video scenario module: Provides a complete solution for long-form video playback.
    implementation project(':scene-longvideo')
}

dependencies {
    // AliPlayerKit scenario modules: Built on the AliPlayerKit core component. Provide out-of-the-box standard playback solutions.
    // Long-form video scenario module: Provides a complete solution for long-form video playback.
    implementation(project(":scene-longvideo"))
}

Étape 4 : Vérifiez l'intégration

Synchronisez Gradle et compilez votre projet pour confirmer que les dépendances et les configurations des modules sont correctes :

./gradlew clean assemble --stacktrace --info       

Consultez les informations de version

Les versions actuelles des SDK dont dépend AliPlayerKit sont définies dans le fichier playerkit/build.gradle.

Vous pouvez consulter les dernières versions et la documentation des SDK associés via les liens suivants :

• Télécharger le SDK Player.

• Historique des versions du SDK Android.

• Implémenter la récupération de flux RTS sur Android.

Étapes de mise à niveau

1. Vérifiez la compatibilité des versions

   Avant la mise à niveau, examinez l'historique des versions et le journal des mises à jour du SDK. Vérifiez si la version cible introduit des changements incompatibles ou d'autres ajustements de compatibilité.

2. Mettez à jour le numéro de version

   Dans le fichier playerkit/build.gradle, mettez à jour les numéros de version des SDK :

   def player_sdk_version = "x.x.x"  // Replace with your target version
   api "com.aliyun.sdk.android:AliyunPlayer:$player_sdk_version-full"
   
   // RtsSDK version must match the player SDK version.
   def rts_sdk_version = "x.x.x"  // Replace with your target version
   api "com.aliyun.rts.android:RtsSDK:$rts_sdk_version"            

3. Vérifiez la mise à niveau :

   • Nettoyez et reconstruisez votre projet :

     ./gradlew clean assemble --stacktrace --info                

   • Testez les fonctions de lecture de base : lecture, pause, recherche et vitesse de lecture.

   • Testez des scénarios de lecture spécifiques, tels que la lecture en direct ultra-faible latence via Real-Time Streaming (RTS).

Problèmes de licence

Problème : Le lecteur affiche une erreur de licence.

Solution :

1. Confirmez que vous avez correctement configuré le certificat et la clé de licence.

2. Vérifiez si votre licence a expiré.

3. Confirmez que le nom du package de votre application correspond au nom du package lié à la licence.

4. Si vous ne configurez pas la licence correcte, la lecture échouera après l'intégration. Vous pourriez observer un écran noir ou d'autres comportements anormaux.

Conflits de dépendances

Problème : La synchronisation Gradle échoue avec une erreur de conflit de dépendances.

Solution :

1. Vérifiez si votre projet contient déjà différentes versions de la même dépendance.

2. Utilisez exclude pour supprimer les dépendances conflictuelles.

3. Standardisez les versions des dépendances dans tout votre projet.

4. Si votre projet utilise déjà la même bibliothèque tierce, ajustez le numéro de version dans le module playerkit pour assurer la compatibilité et éviter les conflits.

Échec de l'initialisation

Problème : L'appel à AliPlayerKit.init() génère une exception.

Solution :

1. Confirmez que le Context n'est pas null.

2. Appelez la méthode dans Application.onCreate().

3. Vérifiez s'il existe des appels dupliqués. Les appels dupliqués sont ignorés et ne génèrent pas d'exceptions.

Problèmes de configuration de la version du SDK

Problème : La compilation échoue avec une erreur de non-concordance de version du SDK.

Solution :

Assurez-vous que la configuration du module playerkit, telle que compileSdkVersion, buildToolsVersion, minSdkVersion et targetSdkVersion, correspond aux paramètres de votre projet.

Problèmes de namespace

Problème : Après avoir copié les modules, la compilation échoue avec des erreurs liées au namespace.

Solution :

Chaque fichier build.gradle de module déclare un namespace par défaut pour prendre en charge Android Gradle Plugin (AGP) 7.x et versions ultérieures. Ajustez ce paramètre en fonction de votre version d'AGP :

Emplacement de la configuration : Dans le bloc android {} du fichier build.gradle de chaque module.

android {
    /// Integration FAQ
    /// Notes about namespace declaration:
    /// - AGP version ≥ 8.0 (for example, 8.3.2): namespace must be declared.
    /// - AGP version < 7.0 (for example, 4.0.1): remove namespace declaration. Use the package attribute in AndroidManifest.xml.
    /// - AGP version 7.x: namespace declaration is optional. We recommend declaring it to support future upgrades.
    namespace = "com.aliyun.playerkit"
    // ...
}  

Émulateur non pris en charge

Problème : Une erreur se produit lors de l'exécution sur un émulateur.

Solution :

Le SDK ApsaraVideo Player ne prend pas en charge les émulateurs. Vous devez effectuer les tests sur un appareil physique après l'intégration.

Conflit de priorité de dépôt

Problème : Gradle signale un conflit lors de la résolution des priorités des dépôts.

Solution :

Pour résoudre ce problème, déclarez les dépôts dans votre fichier settings.gradle.