ApsaraVideo VOD:ライセンスの組み込み

前提条件

ライセンスを申請し、ライセンスファイルとライセンスキーを取得済みであること。詳細については、「ライセンスの管理」をご参照ください。

認証フロー

上図のとおり、ApsaraVideo Media SDK のライセンス認証は、ライセンスキーとライセンスファイルに依存します。設定要件は以下のとおりです。

内蔵のライセンスファイルを省略するには、以下のプラットフォームごとの手順で LicenseFile の設定を省略してください。

ApsaraVideo Player SDK サービス環境

全世界のコンプライアンス要件を満たすため、ApsaraVideo Player SDK V6.14.0 以降は、サービスをローカライズしコンプライアンスを維持する複数のサービス環境を提供します。選択した環境によって、ライセンス認証と ApsaraVideo Player SDK の再生品質データをサポートするサービスセンターが決まります。要件に合ったサービス環境を選択してください。

Alibaba Cloud 国際サイト (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> ノードの名前が正しいかを確認してください。問題が解決しない場合は、トラブルシューティングについて「ライセンスに関する FAQ」をご参照ください。

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

      • 2 セットのライセンスを組み込むことができます。1 つは グローバル (中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) を除く) 用、もう 1 つは 中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) 用です。アプリの起動時に毎回プレーヤーサービス環境を設定します。実行時に環境を切り替えることはできません。

      // 中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) のライセンスを設定 (デフォルトの中国サイト設定)
      <meta-data
          android:name="com.aliyun.alivc_license.licensekey"
          android:value="foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****"/>  <!-- TODO: ライセンスキーの値を設定してください。 -->
      <meta-data
          android:name="com.aliyun.alivc_license.licensefile"
          android:value="assets/cert/release.crt"/>  <!-- TODO: ライセンスファイルのパスを設定してください。 -->
      
      
      // グローバル (中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) を除く) 環境のライセンスを設定。名前の末尾に _SEA を手動で追加します。
      <meta-data
          android:name="com.aliyun.alivc_license.licensekey_SEA"
          android:value="f6b6foIVziMaUHaRqgDyheb8fcf014af39535d0a32720****"/>  <!-- TODO: ライセンスキーの値を設定してください。 -->
      <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 からサービス環境の選択をサポートしています。V6.14.0 以降は、デフォルトで 中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) 環境になります。グローバル (中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) を除く) 環境 (現在、国際サイトユーザーが利用できる唯一の環境) を使用するには、次のいずれかの方法を使用して ApsaraVideo Player SDK を国際サイト環境に切り替えてください。そうしない場合、ライセンス認証は失敗します。他のバージョンや他の 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"/>  

      次の例は設定を示しています。

      <manifest xmlns:android="http://schemas.android.com/apk/res/android">
          <application
              ...>
              <!-- その他の設定 -->
      
              <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>

iOS へのライセンスの組み込み

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

   1. 証明書ファイル AliVideoCert-********.crt を Xcode プロジェクトにコピーします。AppSupportFiles ディレクトリ (推奨)、サンドボックス、またはその他のパスに配置します。[Target Membership] で、現在のプロジェクトを選択します。

      プロジェクトの [Info.plist] ファイルに、次の 2 つの設定項目を追加します。

      • [AlivcLicenseFile] (String)：証明書ファイル名 (例：license.crt) を設定します。

      • [AlivcLicenseKey] (String)：取得したライセンスキーの値を設定します。

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

      重要

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

      • 2 セットのライセンスを組み込むことができます。1 つは グローバル (中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) を除く) 用、もう 1 つは 中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) 用です。アプリの起動時に毎回プレーヤーサービス環境を設定します。実行時に環境を切り替えることはできません。

      // 中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) のライセンスを設定 (デフォルト設定)
      <key>AlivcLicenseFile</key>
      <string>XXX</string>
      <key>AlivcLicenseKey</key>
      <string>foIVziMaUHaRqgDyhf6b6eb8fcf014af39535d0720a32****</string>
      
      
      // グローバル (中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) を除く) 環境のライセンスを設定。キー名の末尾に _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 からサービス環境の選択をサポートしています。V6.14.0 以降は、デフォルトで 中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) 環境になります。グローバル (中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) を除く) 環境 (現在、国際サイトユーザーが利用できる唯一の環境) を使用するには、次のいずれかの方法を使用して ApsaraVideo Player SDK を国際サイト環境に切り替えてください。そうしない場合、ライセンス認証は失敗します。他のバージョンや他の 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>

      また、プロジェクトの [AppSupportFiles] ディレクトリに SEALicense.crt 証明書ファイルを追加する必要もあります。Info.plist ファイルで、以下のキーと値のペアを設定します。

      • AlivcLicenseFile_SEA：SEALicense.crt に設定

      • AlivcLicenseKey_SEA：ライセンスキーに設定

Flutter へのライセンスの組み込み

Flutter は Google が開発したクロスプラットフォームソリューションです。そのため、Flutter では複数のプラットフォームのライセンスを組み込むか、ビジネスシナリオに合ったライセンスを組み込む必要があります。詳細については、「Android へのライセンスの組み込み」または「iOS へのライセンスの組み込み」をご参照ください。