Apsara Video SDK:ライセンスの統合

前提条件

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

認証フロー

上の図に示すように、Apsara Video SDK のライセンス認証は、ライセンスキーとライセンスファイルに基づいて行われます。設定要件は次のとおりです。

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

ApsaraVideo Player SDK のサービス環境

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

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

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

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

   左側のナビゲーションペインで、[SDK Management] > [My Licenses] を選択します。[License Management] タブで、[License Key] フィールドを見つけ、その値をコピーします。

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」でトラブルシューティングをご参照ください。

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

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

      // 中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) のライセンスを設定します (デフォルトの中国サイト設定)
      <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 からサービス環境の選択をサポートしています。V6.14.0 以降は、デフォルトで中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) 環境に設定されています。グローバル (中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) を除く) 環境 (現在、International Website ユーザーが利用できる唯一の環境) を使用するには、次のいずれかの方法で 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 (グローバル (中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) を除く) 環境用) に、「ライセンスの管理」で取得したライセンスキーとライセンスファイルのパスを設定してください。

      重要

      • Alibaba Cloud International Website (www.alibabacloud.com) のユーザーが ApsaraVideo Player SDK V6.14.0 以降を使用する場合は、グローバル (中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) を除く) 環境のライセンスを設定してください。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 以降は、デフォルトで中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) 環境に設定されています。グローバル (中国本土、香港 (中国)、マカオ (中国)、台湾 (中国) を除く) 環境 (現在、International Website ユーザーが利用できる唯一の環境) を使用するには、次のいずれかの方法で 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 でのライセンス統合」をご参照ください。