このトピックでは、ライセンスの申請、更新、使用、およびライセンスにバインドされたアプリケーション情報の変更に関するよくある質問について説明します。
Web Player SDK ライセンスエラー
問題：Web Player SDK の使用時にライセンスエラーが発生します。
解決策：Web Player SDK v2.28.0 以降を使用する場合は、ライセンスサービスを統合する必要があります。新規購入したライセンスは、Web Player SDK の旧バージョンと互換性がありません。最適なパフォーマンスを得るには、バージョン 2.29.1 以降を使用してください。Web Player SDK ライセンスを購入していない場合は、「ApsaraVideo MediaBox SDK」で新しいライセンスを購入してください。購入後、ライセンスを再バインドする必要があります。
モバイル Player SDK ライセンスエラー
問題：モバイル向け Player SDK v7.0.0 以降を使用する際に、「License verify premium func:abr」のようなエラーメッセージが表示される場合があります。
[7.0.0_43566760] [licenseManager] :license verify premium func: abr
[7.0.0_43566760] [licenseManager] :Premium LICENSE INFO NOT VALID!
[7.0.0_43566760] [ResolverManager] :httpdns get ip info timed out
[7.0.0_43566760] [analytics] :eventCode:5004, name: string:li_di * Can not found the business data *||* li_fri * success *|
[7.0.0_43566760] [licenseManager] :license verify premium sdk result is 6, errMsg: Can not found the business data
[7.0.0_43566760] [licenseManager] :
+---------------------------------------------------------------------------------------------------+
|--------------------------------- Premium license is invalid!!! ----------------------------------|
|--------------------- Please provide correct license key before play, --------------------------|
| you can visit 'https://www.alibabacloud.com/help/apsara-video-sdk/user-guide/license/' for more info.|
+---------------------------------------------------------------------------------------------------+
[7.0.0_43566760] [] :check premium failed
[7.0.0_43566760] [] :check premium function: ABR
[7.0.0_43566760] [licenseManager] :license verify premium func: abr
[7.0.0_43566760] [licenseManager] :Premium LICENSE INFO NOT VALID!
[7.0.0_43566760] [analytics] :eventCode:5004, name: string:li_di * Can not found the business data *||* li_fri * success *|解決策：モバイル向け Player SDK v7.0.0 以降では、機能が異なるエディションに分類されています。高度な ABR ポリシーなどの Professional Edition の機能を使用するには、Professional Edition のライセンスを購入してバインドする必要があります。詳細については、「Player SDK ライセンスの取得」をご参照ください。
ライセンスの有効期限と更新
ライセンスの有効期限の確認
ApsaraVideo VOD コンソールまたはApsaraVideo Live コンソールにログインします。
左側のナビゲーションペインで、SDK 管理 > マイライセンス の順に選択します。
[License Management] タブをクリックし、アプリケーションにバインドされているライセンスオーダーを検索して、[Expiration Date] 列で有効期限を確認します。ライセンスを更新するには、[Actions] 列の [Renew] をクリックします。
ライセンスの更新
ライセンスの更新の詳細については、「ライセンスの更新」をご参照ください。
SMS 通知で受信した有効期限とコンソールに表示される日付が異なる場合は、有効期間が手動で延長されたためです。コンソールに表示される有効期限が優先されます。課金管理の「更新」ページに表示される有効期限アラートは無視してかまいません。自動更新機能を無効にすることを推奨します。
複数の SDK 機能を含むレガシーライセンスオーダーをお持ちの場合は、オーダー全体を更新する必要があります。個別の機能のみを更新することはできません。更新方法は 2 つあります。
ライセンスオーダーにインスタンス ID がある場合は、[Actions] 列の [Renew] をクリックします。
ライセンスオーダーにインスタンス ID がない場合は、[Renew] ボタンを使用できません。「ApsaraVideo MediaBox SDK」で新しいライセンスを購入する必要があります。購入後、ライセンスを再バインドする必要があります。
ライセンスエラーのトラブルシューティング
統合の失敗やその他のライセンスエラーが発生した場合は、以下の手順でトラブルシューティングしてください。
ApsaraVideo VOD または ApsaraVideo Live コンソールでライセンス認可が正しく設定されているか確認してください。
ApsaraVideo VOD コンソールまたはApsaraVideo Live コンソールにログインします。
左側のナビゲーションペインで、SDK 管理 > マイライセンス を選択します。
[アプリケーション管理] タブをクリックし、対象のアプリケーションを探して 詳細 をクリックします。ページには、アプリケーションの基本情報と紐付けられたライセンスが表示されます。
以下の情報が正しいか確認してください。
アプリケーションの基本情報：アプリケーション識別子 (パッケージ名など) とパッケージ署名。パッケージ署名のバインドは推奨されません。
バインドされているライセンス情報：SDK バージョン、認可タイプ、有効期限、ステータス、および付加価値サービス。
プロジェクト内のライセンス設定が正しく、コンソール内のライセンス情報と一致しているか確認してください。
Web：プレーヤーの初期化時に使用される
licenseフィールドの設定を確認してください。domain：プレーヤーのページのドメインが、ライセンス申請時に指定したドメインと一致するか、そのサブドメインであることを確認してください。
key：ライセンスキーの値がコンソールに表示されている値と一致していることを確認してください。
Android：
AndroidManifest.xmlの設定を確認してください。ライセンスキー：
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の設定を確認してください。バンドル ID：
CFBundleIdentifierの値がコンソールで設定されているBundle IDと一致していることを確認してください。ライセンスキー：
AlivcLicenseKeyの値がコンソールに表示されているキーと一致していることを確認してください。ライセンスファイル：
AlivcLicenseFileの値がipaパッケージ内のライセンスファイルのパスと一致していることを確認してください。
HarmonyOS：
module.json5の設定を確認してください。バンドル ID：
app.json5のbundleNameがコンソールで設定されている HarmonyOSBundleIDと一致していることを確認してください。ライセンスキー：
com.aliyun.alivc_license.licensekeyの値がコンソールに表示されているキーと一致していることを確認してください。ライセンスファイル：
com.aliyun.alivc_license.licensefileの値がhapパッケージ内のライセンスファイルのパスと一致していることを確認してください。
ライセンスファイルとキーの更新
ライセンスファイル：ライセンスファイルの更新を推奨します。更新後、ライセンスファイル内の有効期限が更新されます。更新されたファイルを使用すると、認証の成功率が向上します。公開済みのアプリの場合、通常、過去のライセンスファイルを使用しても機能に影響はありません。
ライセンスキー：このキーは UID に一意に紐付けられているため、変更されません。
アプリケーション ID の変更
アプリケーション情報が変更された場合は、コンソールで変更できます。
パッケージ名などのアプリケーション識別子を変更すると、元の識別子を使用しているアプリケーションの認証が失敗します。ライセンス証明書ファイルをダウンロードして置き換える必要があります。注意して操作してください。
ApsaraVideo VOD コンソールにログインします。
左側のナビゲーションウィンドウで、SDK 管理 > マイライセンス を選択します。
[アプリケーション管理] タブをクリックし、対象のアプリケーションを見つけて、[編集] をクリックします。
アプリケーション名、プラットフォーム、Android アプリケーション署名の MD5 ハッシュ、およびパッケージ名などのアプリケーション識別子を変更できます。
[変更] をクリックして変更を保存します。
Android MD5 署名の変更
MD5 署名の変更は本番環境で問題を引き起こす可能性があるため、慎重に進めてください。ApsaraVideo MediaBox SDK を使用するアプリには、設定用のライセンスファイルとキーが必要です。MD5 署名などの認可設定を変更すると、リリース済みのアプリバージョンで SDK の認証が失敗し、機能が利用できなくなる可能性があります。一般的なシナリオは次のとおりです。
Android アプリの MD5 署名を A から B に変更すると、署名 A で設定されたアプリバージョンは失敗します。この場合、同じパッケージ名を使用し、新しいアプリバージョン用に署名 B で設定された新しいアプリケーションを作成することを推奨します。
署名のバインドを解除すると、古い SDK バージョンで認証が失敗します。アプリで以下の SDK バージョンを使用したことがある場合は、署名のバインド解除を推奨しません。
ApsaraVideo MediaBox SDK：v1.6.0 以前
Player SDK：v5.5.1.0 以前
Live Streaming SDK：v4.4.8 以前
Short Video SDK：v3.35.0 以前
認可モジュール、エディション、または機能の変更
SDK モジュールを追加したり、既存のモジュールのエディションや機能を変更したりするには、チケットを送信してください。