ApsaraVideo VOD:ライセンスの統合

前提条件

ライセンスの管理から取得したライセンスファイルとライセンスキー。

認証フロー

ライセンス認証は、ライセンスキーとライセンスファイルに依存します。

組み込みのライセンスファイルを使用しない場合は、以下のプラットフォーム別手順で LicenseFile の設定を省略してください。

ApsaraVideo Player SDK のサービス環境

ApsaraVideo Player SDK V6.14.0 以降では、グローバルコンプライアンスに対応するために複数のサービス環境が提供されます。選択した環境によって、ライセンス認証と再生品質データを処理するサービスセンターが決まります。

Alibaba Cloud International Website (www.alibabacloud.com) のユーザーは、グローバル (中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) を除く) 環境 (シンガポールノード) のみ使用できます。V6.14.0 以降のデフォルトは 中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) 環境です。次の手順に従って、設定を国際サイト環境に更新してください。

web クライアントでのライセンスの統合

1. コンソールからライセンスキーを取得します。

2. プレーヤーの初期化時に、登録済みドメイン名とライセンスキーを含む license フィールドを渡します：

   var player = new Aliplayer({
     license: {
       domain: "example.com", // ライセンス申請時に入力したドメイン名
       key: "example-key" // 申請が承認された後にコンソールで確認できるライセンスキー
     }
   });

3. 初期化後にエラーメッセージが表示されなければ、ライセンスは正常に設定されています。

   説明

   ページのドメインは、ライセンス申請で登録したドメインと一致するか、そのサブドメインである必要があります。一致しない場合、検証に失敗します。

Android でのライセンスの統合

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

   1. (推奨) 証明書ファイルを Android Studio プロジェクトの assets ディレクトリにコピーします。

      説明

      また、証明書ファイルをデバイス上の別の場所にコピーすることもできます。ただし、com.aliyun.alivc_license.licensefile (中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) の場合) または com.aliyun.alivc_license.licensefile_SEA (グローバル (中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) を除く) の場合) の値が、ライセンスファイルのパスと一致することを確認してください。

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

      重要

      • ライセンスの設定後に認証に失敗する場合は、<meta-data> 要素が <application> 要素配下に追加されているか、および <meta-data> 要素の name が正しいかを確認してください。問題が解決しない場合は、トラブルシューティングとして「ライセンスに関するFAQ」をご参照ください。

      • Alibaba Cloud International Website (www.alibabacloud.com) のユーザーで、ApsaraVideo Player SDK V6.14.0 以降を使用する場合は、グローバル (中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) を除く) 環境向けのライセンスを設定してください。ApsaraVideo Player SDK を使用しない場合は、中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) 環境向けのライセンスのみを設定してください。

      • グローバル (中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) を除く) 環境向けと 中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) 環境向けの 2 セットのライセンスを統合できます。ライセンスを統合した後、アプリ起動のたびにプレーヤーのサービス環境を設定して動作環境を指定します。プレーヤーの実行中に環境を切り替えることはできません。

      

      // 中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) 向けのライセンスを設定します (デフォルトの China サイト設定)
      <meta-data
          android:name="com.aliyun.alivc_license.licensekey"
          android:value="foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****"/>  <!-- TODO: ご使用の LicenseKey を設定してください。 -->
      <meta-data
          android:name="com.aliyun.alivc_license.licensefile"
          android:value="assets/cert/release.crt"/>  <!-- TODO: ライセンスファイルのパスを設定してください。 -->
      
      
      // グローバル (中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) を除く) 環境向けのライセンスを設定します。name の末尾に _SEA を手動で追加します。
      <meta-data
          android:name="com.aliyun.alivc_license.licensekey_SEA"
          android:value="f6b6foIVziMaUHaRqgDyheb8fcf014af39535d0a32720****"/>  <!-- TODO: ご使用の LicenseKey を設定してください。 -->
      <meta-data
          android:name="com.aliyun.alivc_license.licensefile_SEA"
          android:value="assets/cert/release.crt"/>  <!-- TODO: ライセンスファイルのパスを設定してください。 -->

2. ApsaraVideo Player SDK のサービス環境を設定します (グローバル (中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) を除く) 環境では必須)。

   ApsaraVideo Player SDK V6.14.0 以降のデフォルトは 中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) 環境です。Alibaba Cloud International Website のユーザーは、次のいずれかの方法で グローバル (中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) を除く) 環境に切り替える必要があります。切り替えない場合、ライセンス認証に失敗します。その他のバージョンおよび SDK の利用シナリオでは、この手順は不要です。

   1. 方法 1：次の API を呼び出して、デフォルト設定を国際サイト環境に更新します。

      // グローバル (中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) を除く) 環境を使用する場合は、プレーヤーAPI を呼び出す前に、次のインターフェイスを呼び出してデフォルト設定を国際サイト環境に更新してください。これにより、以降のすべてのサービスが国際サイト環境で実行されます。
      // 統一された AlivcBase インターフェイスを使用して国際サイト環境を設定します。実行時に環境を変更することはできません。
      AlivcBase.getEnvironmentManager().setGlobalEnvironment(AlivcEnv.GlobalEnv.ENV_SEA);

   2. 方法 2 （推奨）: ApsaraVideo Player SDK V7.6.0 以降では、XML 方式を使用して国際サイトの環境を設定します。

      AndroidManifest.xml ファイルに、<meta-data> ノードを追加します。

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

      次の図は設定例です：

iOS でのライセンスの統合

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

   1. お使いの Xcode プロジェクトに、証明書ファイル AliVideoCert-********.crt をコピーします。コピー先は AppSupportFiles ディレクトリを推奨しますが、サンドボックスやその他のパスに配置することもできます。[ターゲットメンバーシップ] で、現在のプロジェクトを選択します。

      

   2. Info.plist ファイルを開きます。ライセンスの管理から取得したライセンスキーとライセンスファイルのパスを、AlivcLicenseKey と AlivcLicenseFile (中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) 環境用) または AlivcLicenseKey_SEA と AlivcLicenseFile_SEA (グローバル (中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) を除く) 環境用) に設定します。

      重要

      • Alibaba Cloud International Website (www.alibabacloud.com) のユーザーで、ApsaraVideo Player SDK V6.14.0 以降を使用する場合は、グローバル (中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) を除く) 環境向けのライセンスを設定してください。ApsaraVideo Player SDK を使用しない場合は、中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) 環境向けのライセンスのみを設定してください。

      • グローバル (中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) を除く) 環境向けと 中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) 環境向けの 2 セットのライセンスを統合できます。ライセンスを統合した後、アプリ起動のたびにプレーヤーのサービス環境を設定して動作環境を指定します。プレーヤーの実行中に環境を切り替えることはできません。

      // 中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) 向けのライセンスを設定します (デフォルト設定)
      <key>AlivcLicenseFile</key>
      <string>XXX</string>
      <key>AlivcLicenseKey</key>
      <string>foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****</string>
      
      
      // グローバル (中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) を除く) 環境向けのライセンスを設定します。key 名の末尾に _SEA を手動で追加します。
      <key>AlivcLicenseFile_SEA</key>
      <string>XXX</string>
      <key>AlivcLicenseKey_SEA</key>
      <string>f6b6efoIVziMaUHaRqgDyhb8fcf014af39535d0a32072****</string>

2. ApsaraVideo Player SDK のサービス環境を設定します (グローバル (中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) を除く) 環境では必須)。

   ApsaraVideo Player SDK V6.14.0 以降のデフォルトは 中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) 環境です。Alibaba Cloud International Website のユーザーは、次のいずれかの方法で グローバル (中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) を除く) 環境に切り替える必要があります。切り替えない場合、ライセンス認証に失敗します。その他のバージョンおよび SDK の利用シナリオでは、この手順は不要です。

   1. 方法 1：次の API を呼び出して、デフォルト設定を国際サイト環境に更新します。

      // グローバル (中国本土、香港 (中国) 、マカオ (中国) 、台湾 (中国) を除く) 環境を使用する場合は、プレーヤーAPI を呼び出す前に、次のインターフェイスを呼び出してデフォルト設定を国際サイト環境に更新してください。これにより、以降のすべてのサービスが国際サイト環境で実行されます。
      // 統一された AlivcBase インターフェイスを使用して国際サイト環境を設定します。実行時に環境を変更することはできません。
      AlivcBase.EnvironmentManager.globalEnvironment = ENV_SEA;

   2. 方法 2 (推奨): ApsaraVideo Player SDK V7.6.0 以降では、Info.Plist メソッドを使用して国際サイト環境を設定します。

      Info.plist ファイルを開き、AlivcEnv を SEA に設定します。

      // 現在の環境を国際サイト環境として設定します。
      <key>AlivcEnv</key>
      <string>SEA</string>

      次の図は設定例です：

Flutter でのライセンスの統合

Flutter アプリケーションの場合は、サポートされている各プラットフォームでライセンスを統合してください：「Android でのライセンスの統合」または「iOS でのライセンスの統合」。