すべてのプロダクト
Search

このプロダクト

    Apsara Video SDK:ライセンスに関するよくある質問

    ドキュメントセンター

    Apsara Video SDK:ライセンスに関するよくある質問

    最終更新日:Nov 09, 2025

    このトピックでは、ライセンスのバインド情報の申請、更新、使用、変更に関する一般的な問題とそのソリューションについて説明します。

    Player SDK for Web でライセンスエラーが発生した場合の対処方法

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

    ソリューション: Web Player SDK V2.28.0 以降を使用する場合、ライセンスを購入する必要があります。これらのライセンスは、2.28.0 より前の Web Player SDK バージョンと互換性がありません。サービスの中断を避けるために、Web Player SDK V2.29.1 以降を使用することを推奨します。Web Player SDK ライセンスを購入していない場合は、またはApsaraVideo MediaBox SDK ページで新しいライセンスを購入できます。購入後、再度ライセンスをバインドする必要があります。

    モバイル向け Player SDK でライセンスエラーが発生した場合の対処方法

    問題: モバイル向け Player SDK V7.0.0 以降を使用すると、「License verify premium func:abr」のようなエラーが発生します。

    image

    ソリューション: モバイル向け Player SDK V7.0.0 以降では、さまざまなエディションで機能が提供されます。高度なアダプティブビットレート (ABR) ポリシーなどの Professional Edition の機能を使用するには、Professional Edition ライセンスを購入してバインドする必要があります。詳細については、「Player SDK のライセンスを取得する」をご参照ください。

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

    ライセンスの有効期限の表示

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

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

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

    ライセンスの更新

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

    重要

    1. 受信した SMS 通知のライセンス有効期限がコンソールの有効期限と異なる場合、これは過去の理由により有効期間が手動で延長されたためです。コンソールの日付が優先されます。経費とコストの 更新 ページにある有効期限のプロンプトは無視してください。自動更新機能を無効にすることを推奨します。

    2. 過去のライセンス注文が複数のソフトウェア開発キット (SDK) 機能を組み合わせたパッケージである場合、ライセンス注文全体を更新する必要があります。個々の機能を個別に更新することはできません。次のいずれかの方法でライセンスを更新できます:

      1. ライセンス注文にインスタンス ID がある場合は、[アクション] 列の [更新] をクリックします。image

      2. ライセンス注文のインスタンス ID が空の場合、[更新] ボタンを使用してライセンスを更新することはできません。または MediaBox オーディオ/ビデオ SDK ページから新しいライセンス注文を購入し、再度ライセンスバインディングを実行する必要があります。

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

    ライセンスの統合に失敗した場合、またはエラーが発生した場合は、次のように問題をトラブルシューティングできます:

    • ApsaraVideo VOD または ApsaraVideo Live コンソールのライセンス権限付与構成が正しいかどうかを確認します。

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

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

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

      4. 次の情報が正しいかどうかを確認します。

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

        • バインドされたライセンス情報: SDK バージョン、権限付与タイプ、有効期限、ステータス、付加価値サービス。

        image

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

      • Web: プレーヤーの初期化コードで license フィールドの構成を確認します。

        • domain: プレーヤーが配置されているページのドメイン名が、ライセンスを申請したときに指定したドメイン名と同じか、そのサブドメインであるかを確認します。

        • key: License Key の値がコンソールに表示されているものと同じであるかを確認します。

      • Android: AndroidManifest.xml の構成を確認します。

        • LicenseKey: com.aliyun.alivc_license.licensekey の値がコンソールに表示されているものと同じであるかを確認します。

        • 証明書ファイル: com.aliyun.alivc_license.licensefile の値が証明書ファイルが保存されているパスと同じであるかを確認します。

        • パッケージ ID: build.gradle の applicationId がコンソールの Package Name と同じであるかを確認します。

        • パッケージ署名: コンソールでライセンスを作成したときに署名をバインドした場合、プロジェクトで構成された署名がコンソールでバインドされたものと同じであることを確認してください。次のコマンドを実行して、パッケージ署名を照会できます: keytool -v -list -keystore your.keystore。

      • iOS: Info.plist の構成を確認します。

        • Bundle ID: CFBundleIdentifier の値がコンソールで構成した Bundle ID と同じであるかを確認します。

        • LicenseKey: AlivcLicenseKey の値がコンソールに表示されているものと同じであるかを確認します。

        • 証明書ファイル: AlivcLicenseFile の値が ipa パッケージ内の証明書ファイルのパスと同じであるかを確認します。

      • HarmonyOS: module.json5 の構成を確認します。

        • BundleId: app.json5 ファイル内の bundleName の値が、コンソールで構成された HarmonyOS の BundleID と同じであるかを確認します。

        • LicenseKey: com.aliyun.alivc_license.licensekey の値がコンソールに表示されているものと同じであるかを確認します。

        • 証明書ファイル: com.aliyun.alivc_license.licensefile の値が hap パッケージ内の証明書ファイルのパスと同じであるかを確認します。

    新しいライセンスを購入して権限付与した後、ライセンスファイルとキーを更新する必要がありますか？

    • ライセンスファイル: ファイルを更新することを推奨します。更新後、ライセンスファイル内の有効期限が更新されます。更新されたライセンスファイルを使用すると、認証の成功率が向上します。一般的に、リリースされたアプリで過去のライセンスファイルを使用しても、その機能には影響しません。

    • License Key: キーは変更されません。License Key は UID と 1 対 1 でマッピングされています。

    アプリケーション ID を変更する方法

    コンソールでライセンスにバインドされているアプリケーションに関する情報を変更できます。

    重要

    パッケージ名などのアプリケーション識別子を変更すると、元の識別子を持つアプリケーションで認証が失敗します。新しい証明書ファイルをダウンロードして古いものを置き換える必要があります。注意して進めてください。

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

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

    3. [アプリケーション管理] タブで、目的のアプリケーションを見つけ、[アクション] 列の [編集] をクリックします。

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

    5. 設定を確認し、[変更] をクリックします。

    Android アプリケーション署名の MD5 ハッシュを変更する

    サービスの中断を防ぐため、署名の MD5 ハッシュは注意して変更してください。ApsaraVideo MediaBox SDK を統合したアプリには、ライセンスファイルとキーが必要です。署名の MD5 ハッシュなどの権限付与構成を変更すると、リリースされたアプリバージョンの SDK が権限付与チェックに失敗する可能性があります。これにより、機能が誤動作する可能性があります。一般的なシナリオは次のとおりです:

    • Android アプリの署名の MD5 ハッシュを A から B に変更すると、「MD5 ハッシュ=A」で構成されたアプリは誤動作します。この場合、別のアプリケーションを作成してください。同じパッケージ名を使用し、新しいバージョンには「MD5 ハッシュ=B」を設定します。

    • 署名のバインドを解除すると、古い SDK バージョンは権限付与チェックに合格できません。アプリで次の SDK バージョンを使用したことがある場合は、署名のバインドを解除しないでください:

      • ApsaraVideo MediaBox SDK: V1.6.0 以前

      • Player SDK: V5.5.1.0 以前

      • Push SDK: V4.4.8 以前

      • Short video SDK: V3.35.0 以前

    権限付与されたモジュール、バージョン、および機能を変更する方法

    現在、コンソールでは構成のアップグレードまたはダウングレードをサポートしていません。SDK モジュールを追加したり、既存の SDK モジュールのバージョンや機能を変更したりするには、チケットを送信してください。