ApsaraVideo VOD:Intégrer une licence

, iOS et HarmonyOS

Prérequis

Vous avez demandé une licence et obtenu le fichier de licence ainsi que la License Key. Pour plus d'informations, consultez la rubrique Gérer une licence.

Flux d'authentification

Comme illustré dans la figure ci-dessus, l'authentification de la licence ApsaraVideo Media SDK repose sur la License Key et le fichier de licence. Les exigences de configuration sont les suivantes :

Pour ignorer le fichier de licence intégré, omettez la configuration LicenseFile dans les étapes spécifiques à la plateforme décrites ci-dessous.

Environnements de service de l'ApsaraVideo Player SDK

Afin de respecter les exigences de conformité mondiales, l'ApsaraVideo Player SDK V6.14.0 et les versions ultérieures proposent plusieurs environnements de service qui maintiennent les services localisés et conformes. L'environnement sélectionné détermine le centre de service qui prend en charge l'authentification de la licence et les données de qualité de lecture de l'ApsaraVideo Player SDK. Sélectionnez l'environnement de service qui répond à vos besoins.

Les utilisateurs du site web international Alibaba Cloud (www.alibabacloud.com) ne peuvent utiliser que l'environnement Global (hors Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine)) (nœud Singapour). Les versions V6.14.0 et ultérieures utilisent par défaut l'environnement Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine). Mettez à jour la configuration vers l'environnement du site international comme suit.

Intégrer une licence sur le client web

1. Obtenez la License Key depuis la console.

   

2. Lors de l'initialisation du lecteur, transmettez le champ license, qui comprend le nom de domaine enregistré et la License Key :

   var player = new Aliplayer({
     license: {
       domain: "example.com", // The domain name you entered when you applied for the license
       key: "example-key" // The License Key you can view in the console after a successful application
     }
   });

3. Si aucun message d'erreur n'apparaît après l'initialisation, la licence est configurée correctement.

   Remarque

   Le domaine de la page doit correspondre ou être un sous-domaine du domaine enregistré lors de votre demande de licence. Sinon, la vérification échoue.

Intégrer une licence sur Android

1. Configurez la licence.

   1. (Recommandé) Copiez le fichier de certificat dans le répertoire assets de votre projet Android Studio.

      Remarque

      Vous pouvez placer le fichier de certificat ailleurs sur l'appareil, mais assurez-vous que com.aliyun.alivc_license.licensefile (pour Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine)) ou com.aliyun.alivc_license.licensefile_SEA (pour Global (hors Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine))) correspond au chemin d'accès réel du fichier.

   2. Dans le fichier AndroidManifest.xml, ajoutez un nœud <meta-data>.

      Important

      • Si la vérification échoue après la configuration de la licence, vérifiez si le nœud <meta-data> est placé sous l'élément <application> et si le nom du nœud <meta-data> est correct. Si le problème persiste, consultez la rubrique FAQ sur les licences pour le dépannage.

      • Pour les utilisateurs du site international (www.alibabacloud.com) disposant de l'ApsaraVideo Player SDK V6.14.0 ou version ultérieure, configurez une licence pour l'environnement Global (hors Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine)). Sans l'ApsaraVideo Player SDK, configurez uniquement l'environnement Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine).

      • Vous pouvez intégrer deux ensembles de licences : un pour Global (hors Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine)) et un pour Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine). Définissez l'environnement de service du lecteur à chaque démarrage de l'application. Vous ne pouvez pas changer d'environnement pendant l'exécution.

      // Configure the license for the Chinese mainland, Hong Kong (China), Macao (China), and Taiwan (China) (default China site configuration)
      <meta-data
          android:name="com.aliyun.alivc_license.licensekey"
          android:value="foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****"/>  <!-- TODO: Set your LicenseKey value. -->
      <meta-data
          android:name="com.aliyun.alivc_license.licensefile"
          android:value="assets/cert/release.crt"/>  <!-- TODO: Set the path of your license file. -->
      
      // Configure the license for the Global (excluding the Chinese mainland, Hong Kong (China), Macao (China), and Taiwan (China)) environment. Manually add _SEA to the end of the name.
      <meta-data
          android:name="com.aliyun.alivc_license.licensekey_SEA"
          android:value="f6b6foIVziMaUHaRqgDyheb8fcf014af39535d0a32720****"/>  <!-- TODO: Set your LicenseKey value. -->
      <meta-data
          android:name="com.aliyun.alivc_license.licensefile_SEA"
          android:value="assets/cert/release.crt"/>  <!-- TODO: Set the path of your license file. -->

2. Configurez l'environnement de service pour l'ApsaraVideo Player SDK (requis pour l'environnement Global (hors Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine))).

   L'ApsaraVideo Player SDK prend en charge la sélection de l'environnement de service à partir de la version V6.14.0. Les versions V6.14.0 et ultérieures utilisent par défaut l'environnement Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine). Pour utiliser l'environnement Global (hors Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine)), qui est actuellement le seul environnement disponible pour les utilisateurs du site international, utilisez l'une des méthodes suivantes pour basculer l'ApsaraVideo Player SDK vers l'environnement du site international. Sinon, l'authentification de la licence échoue. Ignorez cette étape pour les autres versions et les autres SDK.

   1. Méthode 1 : Appelez l'API suivante pour mettre à jour la configuration par défaut vers l'environnement du site international.

      // If you use the Global (excluding the Chinese mainland, Hong Kong (China), Macao (China), and Taiwan (China)) environment, ensure you call the following interface to update the default configuration to the international site environment before calling any player API. This ensures all subsequent services run in the international site environment.
      // Use the unified AlivcBase interface to set the international site environment. You cannot modify the environment at runtime.
      AlivcBase.getEnvironmentManager().setGlobalEnvironment(AlivcEnv.GlobalEnv.ENV_SEA);

   2. Méthode 2 (Recommandée) : Pour l'ApsaraVideo Player SDK V7.6.0 et les versions ultérieures, configurez l'environnement du site international à l'aide de la méthode XML.

      Dans le fichier AndroidManifest.xml, ajoutez un nœud <meta-data>.

      <meta-data
        android:name="com.aliyun.alivc_env"
        android:value="SEA"/>  

      L'exemple suivant illustre une configuration :

      <manifest xmlns:android="http://schemas.android.com/apk/res/android">
          <application
              ...>
              <!-- Other configurations -->
      
              <meta-data
                  android:name="com.aliyun.alivc_license.licensekey_SEA"
                  android:value="xxx" />
              <meta-data
                  android:name="com.aliyun.alivc_license.licensefile_SEA"
                  android:value="assets/SEALicense.crt" />
      
              <meta-data
                  android:name="com.aliyun.alivc_env"
                  android:value="SEA"/>
      
          </application>
      
      </manifest>

Intégrer une licence sur iOS

1. Configurez la licence.

   1. Copiez le fichier de certificat AliVideoCert-********.crt dans votre projet Xcode. Placez-le dans le répertoire AppSupportFiles (recommandé), dans le sandbox ou dans un autre chemin. Dans Target Membership, sélectionnez le projet actuel.

      Dans le fichier Info.plist de votre projet, ajoutez les deux éléments de configuration suivants :

      • AlivcLicenseFile (String) : définissez-le sur le nom du fichier de certificat, par exemple license.crt.

      • AlivcLicenseKey (String) : définissez-le sur la valeur de la License Key que vous avez obtenue.

   2. Ouvrez le fichier Info.plist. Définissez AlivcLicenseKey et AlivcLicenseFile (pour l'environnement Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine)) ou AlivcLicenseKey_SEA et AlivcLicenseFile_SEA (pour l'environnement Global (hors Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine))) sur la License Key et le chemin d'accès au fichier de licence que vous avez obtenus dans la rubrique Gérer une licence.

      Important

      • Pour les utilisateurs du site international (www.alibabacloud.com) disposant de l'ApsaraVideo Player SDK V6.14.0 ou version ultérieure, configurez une licence pour l'environnement Global (hors Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine)). Sans l'ApsaraVideo Player SDK, configurez uniquement l'environnement Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine).

      • Vous pouvez intégrer deux ensembles de licences : un pour Global (hors Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine)) et un pour Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine). Définissez l'environnement de service du lecteur à chaque démarrage de l'application. Vous ne pouvez pas changer d'environnement pendant l'exécution.

      // Configure the license for the Chinese mainland, Hong Kong (China), Macao (China), and Taiwan (China) (default configuration)
      <key>AlivcLicenseFile</key>
      <string>XXX</string>
      <key>AlivcLicenseKey</key>
      <string>foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****</string>
      
      // Configure the license for the Global (excluding the Chinese mainland, Hong Kong (China), Macao (China), and Taiwan (China)) environment. Manually add _SEA to the end of the key name.
      <key>AlivcLicenseFile_SEA</key>
      <string>XXX</string>
      <key>AlivcLicenseKey_SEA</key>
      <string>f6b6efoIVziMaUHaRqgDyhb8fcf014af39535d0a32072****</string>

2. Configurez l'environnement de service pour l'ApsaraVideo Player SDK (requis pour l'environnement Global (hors Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine))).

   L'ApsaraVideo Player SDK prend en charge la sélection de l'environnement de service à partir de la version V6.14.0. Les versions V6.14.0 et ultérieures utilisent par défaut l'environnement Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine). Pour utiliser l'environnement Global (hors Chine continentale, Hong Kong (Chine), Macao (Chine) et Taïwan (Chine)), qui est actuellement le seul environnement disponible pour les utilisateurs du site international, utilisez l'une des méthodes suivantes pour basculer l'ApsaraVideo Player SDK vers l'environnement du site international. Sinon, l'authentification de la licence échoue. Ignorez cette étape pour les autres versions et les autres SDK.

   1. Méthode 1 : Appelez l'API suivante pour mettre à jour la configuration par défaut vers l'environnement du site international.

      // If you use the Global (excluding the Chinese mainland, Hong Kong (China), Macao (China), and Taiwan (China)) environment, ensure you call the following interface to update the default configuration to the international site environment before calling any player API. This ensures all subsequent services run in the international site environment.
      // Use the unified AlivcBase interface to set the international site environment. You cannot modify the environment at runtime.
      AlivcBase.EnvironmentManager.globalEnvironment = ENV_SEA;

   2. Méthode 2 (Recommandée) : Pour l'ApsaraVideo Player SDK V7.6.0 et les versions ultérieures, configurez l'environnement du site international à l'aide de la méthode Info.Plist.

      Ouvrez le fichier Info.plist et définissez AlivcEnv sur SEA.

      // Configure the current environment as the international site environment.
      <key>AlivcEnv</key>
      <string>SEA</string>

      Vous devez également ajouter le fichier de certificat SEALicense.crt au répertoire AppSupportFiles de votre projet. Dans le fichier Info.plist, configurez les paires clé-valeur suivantes :

      • AlivcLicenseFile_SEA : définissez sur SEALicense.crt

      • AlivcLicenseKey_SEA : définissez sur votre License Key

Intégrer une licence sur Flutter

Flutter est une solution multiplateforme développée par Google. Par conséquent, sur Flutter, vous devez intégrer les licences de plusieurs plateformes, ou intégrer la licence qui correspond à votre scénario métier. Pour plus d'informations, consultez les rubriques Intégrer une licence sur Android ou Intégrer une licence sur iOS.