すべてのプロダクト
Search

このプロダクト

    ApsaraVideo VOD:ライセンスに関するよくある質問

    ドキュメントセンター

    ApsaraVideo VOD:ライセンスに関するよくある質問

    最終更新日:May 19, 2026

    このトピックでは、ライセンスの申請、更新、使用、およびライセンスにバインドされたアプリケーション情報の変更に関するよくある質問にお答えします。

    Web プレーヤーでのライセンスエラー

    問題：Player SDK for Web を使用すると、ライセンスエラーが発生します。

    解決策：Player SDK for Web v2.28.0 以降の使用にはライセンスが必要です。新しく購入したライセンスは、以前のバージョンの Player SDK for Web と互換性がありません。すべての機能を確実に利用するために、v2.29.1 以降へのアップグレードを推奨します。Player SDK ライセンスを購入していない場合は、ApsaraVideo MediaBox SDK 購入ページで新しいライセンスを購入してください。購入後、アプリケーションに バインドする必要があります。

    モバイルプレーヤーでのライセンスエラー

    問題：モバイルクライアント向け Player SDK v7.0.0 以降を使用すると、「License verify premium func:abr」のようなエラーメッセージが表示されます。

    image

    解決策：Player SDK v7.0.0 以降は、異なるエディションで利用可能です。ABR の高度なポリシーなどの高度な機能を使用するには、Professional Edition ライセンスを購入してバインドする必要があります。詳細については、「ApsaraVideo Player SDK ライセンスの取得」をご参照ください。

    ライセンスの有効期限の確認と更新

    ライセンスの有効期限の確認

    1. ApsaraVideo VOD コンソールまたはApsaraVideo Live コンソールにログインします。

    2. 左側のナビゲーションペインで、SDK 管理 > マイライセンス を選択します。

    3. [License Management] タブをクリックし、アプリケーションにバインドされたライセンス注文を見つけ、[Expiration Date] 列で有効期限を確認します。image

    ライセンスの更新

    ライセンスの更新に関する詳細については、「ライセンスの更新」をご参照ください。

    重要

    1. 受信したテキストメッセージに記載されているライセンスの有効期限がコンソールに表示される日付と異なる場合、これは過去の経緯から有効期間が手動で延長されたためです。コンソールに表示される有効期限が優先されます。Billing and Cost Management コンソールの [Renewal] ページに表示される有効期限通知は無視してかまいません。自動更新機能を無効にすることを推奨します。

    2. 過去のライセンス注文が複数の SDK 機能をバンドルしている場合、ライセンス注文全体を更新する必要があります。単一の機能を個別に更新することはできません。2つの更新方法があります。

      1. インスタンス ID がある場合は、[Actions] 列の [Renew] をクリックします。image

      2. インスタンス ID がない場合は、[Renew] ボタンを使用できません。ApsaraVideo MediaBox SDK 購入ページで新しいライセンスを購入し、アプリケーションに バインドする必要があります。

    ライセンスエラーのトラブルシューティング方法

    ライセンスの統合中にエラーが発生した場合は、次のトラブルシューティング手順に従ってください。

    • ApsaraVideo VOD コンソールまたは ApsaraVideo Live コンソールでライセンス認可が正しく設定されていることを確認します。

      1. ApsaraVideo VOD コンソールまたはApsaraVideo Live コンソールにログインします。

      2. 左側のナビゲーションペインで、SDK 管理 > マイライセンス を選択します。

      3. [Application Management] タブをクリックし、対象のアプリケーションを見つけて 詳細 をクリックします。アプリケーションの基本情報と、それにバインドされたライセンスが表示されます。

      4. 次の情報が正しいことを確認します。

        • 基本情報：アプリケーション識別子 (パッケージ名など) とパッケージ署名を確認します。パッケージ署名はバインドしないことを推奨します。

        • ライセンス情報：SDK バージョン、認可タイプ、有効期限、ライセンスステータス、および購入した付加価値サービスを確認します。

        image

    • プロジェクト内のライセンス設定が正しく、コンソール内のライセンス情報と一致していることを確認します。

      • Web アプリケーションでは、プレーヤーの初期化中に license フィールドの設定を確認してください。

        • domain：プレーヤーがホストされているページのドメインです。これは、ライセンス申請時に指定したドメイン、またはそのサブドメインのいずれかである必要があります。

        • key: ライセンスキーの値です。この値は、コンソールに表示されるライセンスキーと一致する必要があります。

      • Android: AndroidManifest.xml 内の設定を確認してください。

        • LicenseKey: com.aliyun.alivc_license.licensekey の値がコンソールに表示されるキーと一致することを確認してください。

        • ライセンスファイル: com.aliyun.alivc_license.licensefile の値が、ライセンスファイルが保存されているパスと一致することを確認してください。

        • パッケージ ID: build.gradle 内の applicationId が、コンソールの パッケージ名 と一致することを確認してください。

        • パッケージ署名：コンソールでライセンスを作成する際に署名をバインドした場合、プロジェクトで設定した署名が、コンソールでバインドしたものと一致することを確認してください。パッケージ署名を確認するには、次のコマンドを実行します： keytool -v -list -keystore your.keystore。

      • iOS: Info.plist の設定を確認してください。

        • バンドル ID: CFBundleIdentifier の値が、コンソールで設定した Bundle ID と一致することを確認します。

        • ライセンスキー: AlivcLicenseKey の値がコンソールに表示されるものと一致することを確認してください。

        • ライセンスファイル: AlivcLicenseFile の値が ipa パッケージ内のライセンスファイルのパスと一致することを確認します。

      • HarmonyOS: 確認すべき主な設定は、module.json5 ファイルにあります。

        • BundleId: app.json5 内の bundleName は、コンソールで設定されている HarmonyOS の BundleID と一致する必要があります。

        • ライセンスキー: com.aliyun.alivc_license.licensekey の値は、コンソールに表示されるライセンスキーと一致している必要があります。

        • ライセンスファイル: com.aliyun.alivc_license.licensefile の値は、hap パッケージ内のライセンスファイルへのパスと一致する必要があります。

    ライセンスファイルとライセンスキーの更新

    • ライセンスファイル: ライセンスファイルの更新を推奨します。更新後、ライセンスファイル内の有効期限が更新されます。更新されたライセンスファイルを組み込むことで、認証成功率を向上させることができます。ほとんどの場合、公開済みのアプリで古いライセンスファイルを使用しても、その機能に影響はありません。

    • ライセンスキー：ライセンスキーは変更されません。各ライセンスキーは、ユーザー ID (UID) に一意にマッピングされます。

    アプリケーション ID の変更方法

    アプリケーション情報が変更された場合は、コンソールで変更します。

    重要

    アプリケーション識別子 (パッケージ名など) を変更すると、古い識別子を使用しているアプリケーションの認証が失敗します。ライセンスファイルを再ダウンロードして置き換える必要があります。慎重に操作してください。

    1. ApsaraVideo VOD コンソールにログインします。

    2. 左側のナビゲーションペインで、 を選択します。

    3. [Application Management] タブをクリックします。対象のアプリケーションを見つけ、[Edit] をクリックします。

    4. アプリケーション名、プラットフォーム、Android アプリケーション署名の MD5 ハッシュ、およびパッケージ名などのアプリケーション識別子を変更できます。

    5. [Modify] をクリックして変更を保存します。

    Android パッケージ署名の変更

    オンラインサービスの障害を防ぐため、パッケージ署名の変更は慎重に行ってください。ApsaraVideo MediaBox SDK を使用する場合、アプリには設定用のライセンスファイルとキーが必要です。パッケージ署名などの認可設定を変更すると、公開済みのアプリバージョンでは SDK 認証が失敗し、機能が停止する可能性があります。一般的なシナリオは次のとおりです。

    • Android アプリケーションのパッケージ署名を A から B に変更すると、署名 A を使用するアプリバージョンは動作を停止します。この場合、新しいアプリバージョン用に、同じパッケージ名で署名 B を持つ新しいアプリケーションを作成することを推奨します。

    • パッケージ署名のバインドを解除すると、古い SDK バージョンで認証が失敗する可能性があります。アプリが次のいずれかの SDK バージョンを使用している場合、署名のバインド解除は推奨しません。

      • ApsaraVideo MediaBox SDK：v1.6.0 以前

      • Player SDK：v5.5.1.0 以前

      • Push SDK: v4.4.8 and earlier

      • Short Video SDK：v3.35.0 以前

    認可されたモジュール、エディション、または機能の変更

    コンソールではライセンス設定の変更はサポートされていません。SDK モジュールの追加、または既存の SDK モジュールのエディションや機能の変更が必要な場合は、チケットを送信してください。