Tous les produits
Search

Ce produit

    Apsara Video SDK:FAQ sur les licences

    Centre de documentation

    Apsara Video SDK:FAQ sur les licences

    Dernière mise à jour :Aug 19, 2026

    Cette rubrique répond aux questions fréquentes concernant la demande, le renouvellement, l'utilisation et la modification des informations d'application liées à votre licence.

    Erreurs de licence du SDK Player Web

    Problème : Une erreur de licence se produit lors de l'utilisation du SDK Player Web.

    Solution : Intégrez le service de licence si vous utilisez le SDK Player Web v2.28.0 ou une version ultérieure. Les licences nouvellement achetées ne sont pas compatibles avec les versions antérieures du SDK Player Web. Pour des performances optimales, utilisez la version 2.29.1 ou une version ultérieure. Si vous n'avez pas acheté de licence pour le SDK Player Web, achetez-en une nouvelle sur la SDK ApsaraVideo MediaBox. Après l'achat, vous devez relier la licence.

    Erreurs de licence du SDK Player Mobile

    Problème : Un message d'erreur tel que « License verify premium func:abr » peut apparaître lors de l'utilisation du SDK Player pour mobile v7.0.0 ou d'une version ultérieure.

    [7.0.0_43566760] [licenseManager] :license verify premium func: abr
[7.0.0_43566760] [licenseManager] :Premium LICENSE INFO NOT VALID!
[7.0.0_43566760] [ResolverManager] :httpdns get ip info timed out
[7.0.0_43566760] [analytics] :eventCode:5004, name: string:li_di * Can not found the business data *||* li_fri * success *|
[7.0.0_43566760] [licenseManager] :license verify premium sdk result is 6, errMsg: Can not found the business data
[7.0.0_43566760] [licenseManager] :
                                    +---------------------------------------------------------------------------------------------------+
                                    |--------------------------------- Premium license is invalid!!! ----------------------------------|
                                    |--------------------- Please provide correct license key before play, --------------------------|
                                    | you can visit 'https://www.alibabacloud.com/help/zh/apsara-video-sdk/user-guide/license/' for more info.|
                                    +---------------------------------------------------------------------------------------------------+
[7.0.0_43566760] [] :check premium failed
[7.0.0_43566760] [] :check premium function: ABR
[7.0.0_43566760] [licenseManager] :license verify premium func: abr
[7.0.0_43566760] [licenseManager] :Premium LICENSE INFO NOT VALID!
[7.0.0_43566760] [analytics] :eventCode:5004, name: string:li_di * Can not found the business data *||* li_fri * success *|

    Solution : Dans le SDK Player pour mobile v7.0.0 et les versions ultérieures, les fonctionnalités sont réparties en différentes éditions. Pour utiliser les fonctionnalités de l'édition Professional, telles que les stratégies ABR avancées, vous devez acheter et associer une licence de l'édition Professional. Pour plus d'informations, consultez la section Obtenir une licence pour le SDK Player.

    Expiration et renouvellement de la licence

    Afficher la date d'expiration de la licence

    1. Connectez-vous à la console ApsaraVideo VOD ou à la console ApsaraVideo Live.

    2. Dans le volet de navigation de gauche, choisissez SDK Management > My Licenses.

    3. Cliquez sur l'onglet License Management, repérez la commande de licence associée à votre application et vérifiez sa date d'expiration dans la colonne Expiration Date. Pour renouveler la licence, cliquez sur Renew dans la colonne Actions.

    Renouveler une licence

    Pour plus d'informations sur le renouvellement d'une licence, consultez la section Renouveler une licence.

    Important

    1. Si la date d'expiration indiquée dans la notification SMS que vous avez reçue diffère de celle affichée dans la console, c'est parce que la période de validité a été prolongée manuellement. La date d'expiration indiquée dans la console fait foi. Vous pouvez ignorer les alertes d'expiration sur la page Renewal de Billing Management. Nous vous recommandons de désactiver la fonctionnalité de renouvellement automatique.

    2. Si vous disposez d'une ancienne commande de licence incluant un ensemble de plusieurs fonctionnalités SDK, vous devez renouveler l'intégralité de la commande. Il n'est pas possible de renouveler les fonctionnalités individuellement. Deux méthodes de renouvellement sont disponibles :

      1. Si la commande de licence possède un ID d'instance, cliquez sur Renew dans la colonne Actions.

      2. Si la commande de licence ne possède pas d'ID d'instance, vous ne pouvez pas utiliser le bouton Renew. Vous devez acheter une nouvelle licence sur la SDK ApsaraVideo MediaBox. Après l'achat, vous devez relier la licence.

    Dépannage des erreurs de licence

    Si vous rencontrez des échecs d'intégration ou d'autres erreurs de licence, suivez ces étapes pour résoudre le problème :

    • Vérifiez que l'autorisation de licence est correctement configurée dans la console ApsaraVideo VOD ou ApsaraVideo Live.

      1. Connectez-vous à la console ApsaraVideo VOD ou à la console ApsaraVideo Live.

      2. Dans le volet de navigation de gauche, choisissez SDK Management > My Licenses.

      3. Cliquez sur l'onglet Application Management, repérez l'application cible et cliquez sur Details. La page affiche les informations de base sur l'application et sa licence associée.

      4. Vérifiez si les informations suivantes sont correctes :

        • Informations de base de l'application : identifiant de l'application (tel que le Package Name) et signature du package. Nous vous déconseillons de lier une signature de package.

        • Informations sur la licence associée : version du SDK, type d'autorisation, date d'expiration, statut et services à valeur ajoutée.

    • Vérifiez que la configuration de la licence dans votre projet est correcte et correspond aux informations de licence dans la console.

      • Web : Vérifiez la configuration du champ license utilisé lors de l'initialisation du lecteur.

        • domain : Assurez-vous que le domaine de la page de votre lecteur correspond ou est un sous-domaine du domaine spécifié lors de la demande de licence.

        • key : Assurez-vous que la valeur de License Key correspond à la valeur affichée dans la console.

      • Android : Vérifiez la configuration du fichier AndroidManifest.xml.

        • Clé de licence : Assurez-vous que la valeur de com.aliyun.alivc_license.licensekey correspond à la clé affichée dans la console.

        • Fichier de licence : Assurez-vous que la valeur de com.aliyun.alivc_license.licensefile correspond au chemin de stockage de votre fichier de licence.

        • ID de package : Assurez-vous que l'applicationId dans build.gradle correspond au Package Name dans la console.

        • Signature du package : Si vous avez lié une signature lors de la création de la licence dans la console, assurez-vous que la signature configurée dans votre projet correspond à celle de la console. Vous pouvez exécuter la commande suivante pour interroger la signature de votre package : keytool -v -list -keystore your.keystore.

      • iOS : Vérifiez la configuration du fichier Info.plist.

        • BundleId : Assurez-vous que la valeur de CFBundleIdentifier correspond au Bundle ID configuré dans la console.

        • Clé de licence : Assurez-vous que la valeur de AlivcLicenseKey correspond à la clé affichée dans la console.

        • Fichier de licence : Assurez-vous que la valeur de AlivcLicenseFile correspond au chemin du fichier de licence dans votre package ipa.

      • HarmonyOS : Vérifiez la configuration du fichier module.json5.

        • BundleId : Assurez-vous que le bundleName dans app.json5 correspond au BundleID HarmonyOS configuré dans la console.

        • Clé de licence : Assurez-vous que la valeur de com.aliyun.alivc_license.licensekey correspond à la clé affichée dans la console.

        • Fichier de licence : Assurez-vous que la valeur de com.aliyun.alivc_license.licensefile correspond au chemin du fichier de licence dans votre package hap.

    Mise à jour du fichier de licence et de la clé

    • Fichier de licence : Nous vous recommandons de mettre à jour le fichier de licence. Après le renouvellement, la date d'expiration dans le fichier de licence est mise à jour. L'utilisation du fichier mis à jour améliore le taux de réussite de l'authentification. Pour les applications publiées, l'utilisation d'un fichier de licence historique n'affecte généralement pas les fonctionnalités.

    • Clé de licence : Cette clé reste inchangée, car elle est uniquement liée à votre UID.

    Modification de l'ID d'application

    Si les informations de votre application changent, vous pouvez les modifier dans la console.

    Important

    La modification de l'identifiant d'une application, tel que son nom de package, invalidera l'identifiant d'origine. Vous devez télécharger à nouveau le fichier de licence et remplacer celui existant. Procédez avec prudence.

    1. Connectez-vous à la console ApsaraVideo VOD ou à la console ApsaraVideo Live.

    2. Dans le volet de navigation de gauche, choisissez SDK Management > My Licenses.

    3. Cliquez sur l'onglet Application Management, repérez l'application cible et cliquez sur Edit

      .

    4. Vous pouvez modifier le nom de l'application, la plateforme, la valeur MD5 de la signature de l'application Android et les identifiants de l'application, tels que le nom du package.

    5. Après avoir confirmé les modifications, cliquez sur Modify pour finaliser la modification de la licence.

    Modification de la signature MD5 Android

    La modification de la signature MD5 peut entraîner des problèmes en production, procédez donc avec prudence. Les applications qui utilisent le SDK ApsaraVideo MediaBox nécessitent un fichier de licence et une clé pour la configuration. Si vous modifiez les paramètres d'autorisation, tels que la signature MD5, le SDK dans une version d'application publiée pourrait échouer lors de l'authentification, rendant certaines fonctionnalités indisponibles. Voici les scénarios courants :

    • Si vous modifiez la signature MD5 d'une application Android de A à B, la version de l'application configurée avec la signature A échouera. Dans ce cas, nous vous recommandons de créer une nouvelle application qui utilise le même nom de package mais est configurée avec la signature B pour les nouvelles versions de l'application.

    • Si vous dissociez la signature, les anciennes versions du SDK échoueront lors de l'authentification. Nous vous déconseillons de dissocier la signature si votre application a déjà utilisé les versions de SDK suivantes :

      • SDK ApsaraVideo MediaBox : v1.6.0 et versions antérieures

      • SDK Player : v5.5.1.0 et versions antérieures

      • SDK Live Streaming : v4.4.8 et versions antérieures

      • SDK Short Video : v3.35.0 et versions antérieures

    Modification des modules, éditions ou fonctionnalités autorisés

    Pour ajouter des modules SDK ou modifier l'édition ou les fonctionnalités d'un module existant, ouvrez un ticket.