すべてのプロダクト
Search

このプロダクト

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

    ドキュメントセンター

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

    最終更新日:Nov 05, 2025

    ApsaraVideo MediaBox SDK のライセンスは、アプリケーションの ID にバインドされており、アプリケーションによる SDK の呼び出しを承認します。SDK ライセンスを取得したら、対応する Push SDK、短編動画 SDK、ApsaraVideo Player SDK、または Queen SDK にライセンスを統合して、権限付与を完了する必要があります。このトピックでは、Web、Android および iOS クライアントでライセンスを統合する方法について説明します。

    前提条件

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

    権限付与フロー

    上図に示すように、ApsaraVideo MediaBox SDK のライセンス権限付与フローは LicenseKey とライセンスファイルに依存します。構成要件は次のとおりです。

    項目

    必須

    説明

    LicenseKey

    はい

    ライセンスファイルの更新をリクエストするために使用されます。

    SDK は、初期化中および実行時に 15 分ごとに証明書ファイルの更新をチェックします。

    ライセンスファイル

    いいえ、ただし推奨されます。

    サーバーから証明書を正常にリクエストできない場合に、権限付与に使用される証明書ファイルです。これは、ネットワークの問題で証明書をダウンロードできない場合など、極端なシナリオで発生する可能性があります。

    証明書ファイルには、付与された権限と有効期間が含まれています。ネットワーク状態が悪い場合の権限付与の成功率を向上させるには、権限が変更されたときに内蔵の証明書ファイルを更新します。

    説明

    1. 権限は通常、新しいサービスをアクティベートしたり、付加価値サービス (VAS) を有効にしたり、サービスを更新したりするときに変更されます。

    2. Web クライアント用のライセンスファイルを設定する必要はありません。

    特別な理由で内蔵ライセンスファイルを使用したくない場合は、LicenseFile 関連の構成を空のままにすることができます。詳細については、以降のセクションをご参照ください。

    説明

    内蔵の証明書ファイルを設定しない場合、権限付与は完全にサーバーに依存します。これにより、ネットワークの不安定性により権限付与が不安定になる可能性があります。また、アプリケーションを初めて使用する際に、ユーザーが権限付与される前に証明書のダウンロードを待つ必要がある場合もあります。必要な時間は、ユーザーのネットワーク状態によって異なります。

    ApsaraVideo Player SDK サービス環境

    グローバルなコンプライアンス要件を満たすために、ApsaraVideo Player SDK V6.14.0 以降では、サービスのローカライズとコンプライアンスを確保するためのさまざまな環境オプションが提供されています。選択したサービス環境に基づいて、ApsaraVideo Player SDK のライセンス権限付与と再生品質サービスデータは、対応するサービスセンターによって処理されます。必要に応じてサービス環境を選択できます。

    Alibaba Cloud 国際サイトのユーザーは、グローバル (中国本土、香港 (中国)、マカオ (中国)、および台湾 (中国) を除く) 環境 (シンガポールノード) のみを使用できます。ApsaraVideo Player SDK V6.14.0 以降では、デフォルトで 中国本土、香港 (中国)、マカオ (中国)、および台湾 (中国) の環境構成が使用されます。スムーズなライセンス権限付与プロセスを確保するには、以下で説明するように、ApsaraVideo Player SDK の構成を国際サイトの環境に更新する必要があります。

    環境

    説明

    中国本土、香港 (中国)、マカオ (中国)、および台湾 (中国)

    中国サイト (aliyun.com) 環境 (デフォルト)。このサービスは、中国の上海にある Alibaba Cloud ノードを通じて提供され、中国本土、香港 (中国)、マカオ (中国)、および台湾 (中国) のユーザーのアクセスと権限付与のニーズを満たします。

    グローバル (中国本土、香港 (中国)、マカオ (中国)、および台湾 (中国) を除く)

    国際サイト (alibabacloud.com) 環境: 国際サイトのユーザー向けに設計された環境で、シンガポールノードからサービスを提供し、特定のリージョンのコンプライアンスとパフォーマンス要件を満たします。

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

    1. コンソールから License Key を取得します。image

    2. プレーヤーを初期化するときに、登録済みのドメイン名と License Key を含む `license` フィールドを渡します。

      var player = new Aliplayer({
  license: {
    domain: "example.com", // ライセンスをリクエストしたときに入力したドメイン名
    key: "example-key" // リクエストが承認された後にコンソールに表示される License 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 以降を使用する場合は、グローバル (中国本土、香港 (中国)、マカオ (中国)、および台湾 (中国) を除く) 環境のライセンスを構成する必要があります。ApsaraVideo Player SDK を使用しない場合は、中国本土、香港 (中国)、マカオ (中国)、および台湾 (中国) 環境のライセンスのみを構成できます。

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

        License配置-android-EN3.png

        // 中国本土、香港 (中国)、マカオ (中国)、および台湾 (中国) のライセンスを構成します (デフォルトの中国サイト構成)
<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: ライセンスファイルのパスを設定してください。 -->


// グローバル (中国本土、香港 (中国)、マカオ (中国)、および台湾 (中国) を除く) 環境のライセンスを構成します。名前の末尾に手動で _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 以降では、サービス環境を選択できます。デフォルトの構成は 中国本土、香港 (中国)、マカオ (中国)、および台湾 (中国) 環境用です。グローバル (中国本土、香港 (中国)、マカオ (中国)、および台湾 (中国) を除く) 環境 (現在、国際サイトのユーザーはこの環境のみ使用できます) を使用するには、次のいずれかの方法を使用して、ApsaraVideo Player SDK の構成を国際サイトの環境に更新する必要があります。そうしないと、ApsaraVideo Player SDK のライセンス権限付与が失敗します。他の SDK バージョンやシナリオでは、このステップをスキップできます。

      1. 方法 1: 次のメソッドを呼び出して、デフォルトの構成を国際サイトの環境に更新します。

        // グローバル (中国本土、香港 (中国)、マカオ (中国)、および台湾 (中国) を除く) 環境を使用する場合は、プレーヤー 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"/>

        次の図に構成例を示します。1754556751170-7001527b-36a7-4ebd-8887-e0972a3d64e3

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

    1. ライセンスを構成します。

      1. AliVideoCert-********.crt 証明書ファイルを Xcode プロジェクトに追加します。AppSupportFiles フォルダに配置することをお勧めしますが、サンドボックスや別のパスに配置することもできます。[Target Membership] で、現在のプロジェクトを選択します。

        p687320

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

        重要

        • 国際サイトのユーザーの場合、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 以降では、サービス環境を選択できます。デフォルトの構成は 中国本土、香港 (中国)、マカオ (中国)、および台湾 (中国) 環境用です。グローバル (中国本土、香港 (中国)、マカオ (中国)、および台湾 (中国) を除く) 環境 (現在、国際サイトのユーザーはこの環境のみ使用できます) を使用するには、次のいずれかの方法を使用して、ApsaraVideo Player SDK の構成を国際サイトの環境に更新する必要があります。そうしないと、ApsaraVideo Player SDK のライセンス権限付与が失敗します。他の SDK バージョンやシナリオでは、このステップをスキップできます。

      1. 方法 1: 次のメソッドを呼び出して、デフォルトの構成を国際サイトの環境に更新します。

        // グローバル (中国本土、香港 (中国)、マカオ (中国)、および台湾 (中国) を除く) 環境を使用する場合は、プレーヤー 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>

        次の図に構成例を示します。1754557498401-1d235342-3c0b-4c83-bcee-ae7656e8ff23

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

    Flutter は Google が開発したクロスプラットフォームソリューションです。したがって、Flutter クライアントの場合、Android と iOS の両方のライセンスを統合するか、ビジネスシナリオに基づいて適切なライセンスを統合する必要があります。詳細については、「Android クライアントでのライセンスの統合」または「iOS クライアントでのライセンスの統合」をご参照ください。