:ライセンスのバインド

前提条件

ライセンスが購入され、有効化されます。 ライセンスキーとライセンスファイルを取得します。 詳細については、「ライセンスの申請」をご参照ください。

認証フローチャート

前の図に示すように、ApsaraVideo MediaBox SDKは、ライセンスキーとライセンスファイルを使用してアプリケーションを認証します。 次の表に、ライセンスキーとライセンスファイルの設定要件を示します。

組み込みライセンスファイルを設定しない場合は、アプリケーションにライセンスをバインドするときに関連する設定をスキップします。

Player SDKのサービス環境

ApsaraVideo Player SDK 6.14.0以降は、グローバルなコンプライアンス要件を満たすために、複数のサービス環境を提供し、サービスがローカライズされ、準拠していることを確認します。 ApsaraVideo Player SDKのサービス環境を選択すると、選択したサービス環境のサービスセンターは、ライセンスベースの認証に必要なデータと再生品質に関連するデータを提供します。 ビジネス要件に基づいてサービス環境を選択できます。 利用可能なサービス環境を次の表に示します。

Alibaba Cloud国際サイト (alibabacloud.com) のユーザーは、シンガポールリージョンのノードのみを使用できます。 デフォルトでは、グローバル環境はApsaraVideo Player SDK 6.14.0以降に設定されています。 スムーズなライセンスベースの認証を確保するには、ApsaraVideo Player SDKのAlibaba Cloud国際サイトにサービス環境を更新する必要があります。

Androidアプリケーションにライセンスをバインドする

1. ライセンスを設定します。

   1. (推奨) ライセンスファイルをAndroid Studioプロジェクトのアセットディレクトリにコピーします。

      説明

      ライセンスファイルをデバイス上の別のディレクトリにコピーすることもできます。 その場合は、グローバル環境のcom.aliyun.alivc_license.licensefile、または手順2のAlibaba Cloud国際サイト (alibabacloud.com) のcom.aliyun.alivc_license.licensefile_SEAに対応する値が、ライセンスファイルのパスと同じであることを確認してください。

   2. AndroidManifest.xmlファイルに <meta-data> 要素を追加します。

      重要

      • ライセンスの設定後に認証が失敗した場合は、<application> 要素の下に <meta-data> 要素が追加されているかどうか、および <meta-data> 要素の名前が正しいかどうかを確認します。 問題が解決しない場合は、FAQ about licensesトピックを参照して問題のトラブルシューティングを行います。

      • Alibaba Cloud国際サイト (alibabacloud.com) でApsaraVideo Player SDK 6.14.0以降を使用する場合は、Alibaba Cloud国際サイト (alibabacloud.com) のライセンスを設定する必要があります。 ApsaraVideo Player SDKを使用しない場合は、グローバル環境のライセンスを設定できます。

      • グローバル環境のライセンスとAlibaba Cloud国際サイト (alibabacloud.com) のライセンスを含む2つのライセンスを同時にアプリケーションにバインドできます。 次に、アプリケーションを起動するたびにApsaraVideo player SDKのサービス環境を設定することで、プレーヤーを使用する環境を指定できます。 プレイヤーの実行中は環境を切り替えることはできません。

      

      // Configure a license for the global environment. This is the default configuration.
      <meta-data
          android:name="com.aliyun.alivc_license.licensekey"
          android:value="foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****"/>  <!-- TODO: Specify the license key.-->
      <meta-data
          android:name="com.aliyun.alivc_license.licensefile"
          android:value="assets/cert/release.crt"/>  <!-- TODO: Specify the path of your license file.-->
      
      
      // Configure a license for the Alibaba Cloud international site (alibabacloud.com) and manually add _SEA to the end of the license name.
      <meta-data
          android:name="com.aliyun.alivc_license.licensekey_SEA"
          android:value="f6b6foIVziMaUHaRqgDyheb8fcf014af39535d0a32720****"/>  <!-- TODO: Specify the license key.-->
      <meta-data
          android:name="com.aliyun.alivc_license.licensefile_SEA"
          android:value="assets/cert/release.crt"/>  <!-- TODO: Specify the path of your license file.-->

2. ApsaraVideo Player SDKのサービス環境を設定します。 この手順は、Alibaba Cloud国際サイト (alibabacloud.com) を使用する場合に必要です。

   ApsaraVideo Player SDK 6.14.0以降では、サービス環境を選択できます。 デフォルトでは、グローバル環境はApsaraVideo Player SDK 6.14.0以降に設定されています。 Alibaba Cloud国際サイト (alibabacloud.com) のユーザーは、グローバル環境を使用できません。 Alibaba Cloud国際サイト (alibabacloud.com) を使用する場合は、アプリケーションを起動するたびに、次の方法でApsaraVideo Player SDK用のサービス環境をAlibaba Cloud国際サイト (alibabacloud.com) に更新する必要があります。 それ以外の場合、アプリケーションにApsaraVideo Player SDKの使用を許可するライセンスが認証に失敗します。 6.14.0より前のバージョンのApsaraVideo Player SDKを使用する場合、または他のシナリオでは、この手順は無視できます。

   // When you use the Alibaba Cloud international site (alibabacloud.com), make sure that you have called the following operation to update the default environment to the Alibaba Cloud international site (alibabacloud.com) before you call an API operation of the player. This ensures that all subsequent services run on the Alibaba Cloud international site (alibabacloud.com).
   // Configure the environment to the Alibaba Cloud international site (alibabacloud.com) by calling the unified API operation of AlivcBase. You cannot change the environment when the player is running.
   AlivcBase.getEnvironmentManager().setGlobalEnvironment(AlivcEnv.GlobalEnv.ENV_SEA);

iOSアプリケーションへのライセンスのバインド

1. ライセンスを設定します。

   1. ライセンスファイルをXcodeプロジェクトの指定されたディレクトリにコピーし、ターゲットメンバーシップで現在のプロジェクトを選択します。

      

   2. Info.plistファイルを開きます。 グローバル環境のAlivcLicenseKeyおよびAlivcLicenseFileパラメーター、またはAlibaba Cloud国際サイト (alibabacloud.com) のAlivcLicenseKey_SEAおよびAlivcLicenseFile_SEAパラメーターを、ライセンス申請時に取得したライセンスキーおよびライセンスファイルパスに設定します。

      重要

      • Alibaba Cloud国際サイト (alibabacloud.com) でApsaraVideo Player SDK 6.14.0以降を使用する場合は、Alibaba Cloud国際サイト (alibabacloud.com) のライセンスを設定する必要があります。 ApsaraVideo Player SDKを使用しない場合は、グローバル環境のライセンスを設定できます。

      • グローバル環境のライセンスとAlibaba Cloud国際サイト (alibabacloud.com) のライセンスを含む2つのライセンスを同時にアプリケーションにバインドできます。 次に、アプリケーションを起動するたびにApsaraVideo player SDKのサービス環境を設定することで、プレーヤーを使用する環境を指定できます。 プレイヤーの実行中は環境を切り替えることはできません。

      // Configure a license for the global environment. This is the default configuration.
      <key>AlivcLicenseFile</key>
      <string>XXX</string>
      <key>AlivcLicenseKey</key>
      <string>foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****</string>
      
      
      // Configure a license for the Alibaba Cloud international site (alibabacloud.com) and manually add _SEA to the end of the license name.
      <key>AlivcLicenseFile_SEA</key>
      <string>XXX</string>
      <key>AlivcLicenseKey_SEA</key>
      <string>f6b6efoIVziMaUHaRqgDyhb8fcf014af39535d0a32072****</string>

2. ApsaraVideo Player SDKのサービス環境を設定します。

   ApsaraVideo Player SDK 6.14.0以降では、サービス環境を選択できます。 デフォルトでは、グローバル環境はApsaraVideo Player SDK 6.14.0以降に設定されています。 Alibaba Cloud国際サイト (alibabacloud.com) のユーザーは、グローバル環境を使用できません。 Alibaba Cloud国際サイト (alibabacloud.com) を使用する場合は、アプリケーションを起動するたびに、次の方法でApsaraVideo Player SDK用のサービス環境をAlibaba Cloud国際サイト (alibabacloud.com) に更新する必要があります。 それ以外の場合、アプリケーションにApsaraVideo Player SDKの使用を許可するライセンスが認証に失敗します。 6.14.0より前のバージョンのApsaraVideo Player SDKを使用している場合、または他のシナリオでは、この手順は無視できます。

   // When you use the Alibaba Cloud international site (alibabacloud.com), make sure that you have called the following operation to update the default environment to the Alibaba Cloud international site (alibabacloud.com) before you call an API operation of the player. This ensures that all subsequent services run on the Alibaba Cloud international site (alibabacloud.com).
   // Configure the environment to the Alibaba Cloud international site (alibabacloud.com) by calling the unified API operation of AlivcBase. You cannot change the environment when the player is running.
   AlivcBase.EnvironmentManager.globalEnvironment = ENV_SEA;