このトピックでは、アプリケーションにバインドされているライセンスの登録、更新、使用、および変更に関するよくある質問 (FAQ) に対する回答を提供します。
ライセンスをアプリケーションにバインドするときに報告されるエラーのトラブルシューティングを行うにはどうすればよいですか?
ライセンスのバインドに失敗した場合、またはライセンスのバインド時にエラーが報告された場合は、次の操作を実行してエラーのトラブルシューティングを行います。
ApsaraVideo VODコンソールでライセンス認証設定が正しいかどうかを確認します。
ApsaraVideo VODコンソールにログインします。
左側のナビゲーションウィンドウで、
を選択します。[アプリケーション管理] タブをクリックして、ライセンスにバインドするアプリケーションを見つけ、[詳細] をクリックしてアプリケーションの詳細を表示します。
次の情報が正しいかどうかを確認してください。
パッケージ名、バンドルID、署名などの基本情報。 署名をライセンスにバインドしないことを推奨します。
SDKのバージョン、認証タイプ、有効期限、ライセンスステータス、購入した付加価値サービスなどのライセンス情報。
アプリケーションプロジェクトのライセンス設定が正しく、コンソールのライセンス情報と一致しているかどうかを確認します。
Android:
AndroidManifest.xml
設定ファイルを確認します。ライセンスキー:
com.aliyun.alivc_license.licensekey
の値がコンソールに表示されるライセンスキーと同じかどうかを確認します。ライセンスファイル:
com.aliyun.alivc_license.licensefile
の値が、ライセンスファイルが格納されているパスと同じかどうかを確認します。パッケージ名:
build.gradle
ファイルのapplicationId
の値が、コンソールに表示されるパッケージ名と同じかどうかを確認します。パッケージ署名: 署名をライセンスにバインドする場合は、プロジェクトで設定された署名がコンソールに表示される署名と同じかどうかを確認します。 次のコマンドを実行して、パッケージの署名を照会できます。
keytool -v -list -keystore your.keystore
iOS:
Info.plist
設定ファイルを確認します。バンドルID:
CFBundleIdentifier
の値がコンソールに表示されるバンドルIDと同じかどうかを確認します。ライセンスキー:
AlivcLicenseKey
の値がコンソールに表示されるライセンスキーと同じかどうかを確認します。ライセンスファイル:
AlivcLicenseFile
の値がIPA
パッケージのライセンスファイルのパスと同じかどうかを確認します。
必要な権限がないことを求められた場合はどうすればよいですか?
RAM (Resource Access Management) ユーザーとしてApsaraVideo VODコンソールにログインする前に、RAMユーザーは権限を取得する必要があります。 詳細については、「RAMユーザーにコンソールの使用許可」をご参照ください。 RAMユーザーに必要な権限が付与されていない場合、エラーが発生します。
RAMユーザーに権限が付与されていない場合、 ApsaraVideo VODコンソールにRAMユーザーとしてアクセスすると、次の図に示すエラーメッセージが返されます。。
RAMユーザーに、課金管理コンソールで注文を表示、支払い、またはキャンセルする権限が付与されていない場合、次の図に示すエラーメッセージが返されます。
無料ライセンスを申請するにはどうすればよいですか?
ApsaraVideo VODやApsaraVideo LiveなどのAlibaba Cloudメディアサービスの使用中に、関連する要件を満たしていれば、1年間無料でライセンスの使用を申請できます。 無料ライセンスを申請するには、リクエストを送信してください。 次の表に、無料で利用できるSDKライセンスを示します。
SDK | エディション | サポートされているサービス | 要件 |
ApsaraVideo Player SDK | Standard Edition 付加価値機能はありません |
| 非該当 |
プッシュSDK | Standard EditionまたはInteractive Edition | ApsaraVideo Live | 非該当 |
短いビデオSDK | Basic Edition |
| リソースプランで消費した金額がCNY 1,800を超えています。 |
短いビデオSDK | Standard Edition |
| リソースプランで消費した金額がCNY 30,000を超えています。 |
クイーンSDK | Basic Edition |
| リソースプランで消費した金額がCNY 99を超えています。 |
新しいライセンスを購入して有効化した後、ライセンスファイルとライセンスキーを更新する必要がありますか?
ライセンスファイルを更新することを推奨します。 ライセンスを更新すると、ライセンスファイルの有効期限が更新されます。 更新されたライセンスファイルを統合すると、リクエスト認証の成功率が向上します。 ほとんどの場合、ライセンスの更新はオンラインアプリケーションの操作に影響しません。
ライセンスキーはAlibaba CloudアカウントのIDにバインドされ、変更されません。
アプリケーションのIDを変更するにはどうすればよいですか?
ApsaraVideo VODコンソールで、ライセンスにバインドされているアプリケーションに関する情報を変更できます。
パッケージ名またはバンドルIDを変更すると、アプリケーションの承認に失敗する可能性があります。 この場合、ライセンスファイルをダウンロードしてアプリケーションプロジェクトに再統合する必要があります。 作業は慎重に行ってください。
ApsaraVideo VODコンソールにログインします。
左側のナビゲーションウィンドウで、
を選択します。[アプリケーション管理] タブをクリックし、情報を変更するアプリケーションを見つけて、[編集] をクリックします。
アプリケーション名、プラットフォーム、AndroidアプリケーションのMD5署名、アプリケーション識別子などのアプリケーション情報を変更します。
[変更] をクリックして変更を保存します。
Androidアプリケーションの署名のMD5値を変更できますか?
Androidアプリケーションの署名のMD5値を変更すると、予期しない問題が発生する可能性があります。 この操作を実行するときは注意することを推奨します。 ApsaraVideo MediaBox SDKをアプリケーションと統合する場合は、ライセンスファイルとライセンスキーを設定する必要があります。 署名のMD5値などの既存の認証設定を変更すると、アプリケーションの公開バージョンのSDK認証検証で失敗する可能性があります。 この場合、アプリケーションは期待どおりに機能しません。 Androidアプリケーションの署名のMD5値を変更すると、次のような場合があります。
署名のMD5値をAからBに変更すると、アプリケーションは署名のMD5値がAであることを示すエラーを報告します。この場合、既存のアプリケーションと同じパッケージ名を持つ別のアプリケーションを作成し、新しいアプリケーションの署名のMD5値としてBを指定することをお勧めします。
署名のバインドを解除すると、以前のバージョンのSDKは認証検証に合格しません。 アプリケーションが次のSDKバージョンのいずれかを使用している場合は、署名のバインドを解除しないことを推奨します。
ApsaraVideo MediaBox SDK V1.6.0およびそれ以前
ApsaraVideo Player SDK V5.5.1.0およびそれ以前
プッシュSDK V4.4.8およびそれ以前
短いビデオSDK V3.35.0およびそれ以前
SDKのバージョン、モジュール、または機能を変更するにはどうすればよいですか。
ApsaraVideo VODまたはApsaraVideo LiveコンソールでSDKの設定を変更することはできません。 SDKモジュールの追加、SDKバージョンの変更、SDK機能の変更を行う場合は、リクエストを送信します。
ライセンス認証に失敗し、「ライセンス認証に失敗しました」または「ライセンスが無効です」というエラーメッセージが表示された場合はどうすればよいですか?
次の操作を実行して、エラーをトラブルシューティングします。
ライセンス取得時に指定したパッケージ名、Androidアプリケーションの署名、およびiOSアプリケーションのバンドルIDが正しいかどうかを確認します。
次のいずれかの方法を使用して、Androidアプリケーションの署名を取得できます。
keytool -v -list -keystore your.keystore
コマンドを実行して、署名のMD5値を取得します。Android Studioから署名を取得するには、右側のナビゲーションウィンドウで [Gradle] をクリックし、対応するアプリケーションを見つけて、[Tasks]> [android]> [signingReport] を選択します。 MD5値を小文字の値に変換し、セミコロン (;) を削除する必要があります。
取得したライセンスが、使用するSDKの機能とエディションと一致するかどうかを確認します。
たとえば、次のシナリオでエラーが発生します。Short video SDKとApsaraVideo Player SDKの両方を使用する場合、Short video SDKのライセンスのみを取得します。 Professional Editionを使用する場合は、Short video SDK Basic Editionのライセンスを取得します。 スクリーンミラーリングやデバイス上の超解像度などの付加価値機能を使用する場合は、ApsaraVideo Player SDK Standard Editionのライセンスを取得します。
ライセンスが正しく設定されているかどうかを確認します。
<meta-data>
ノードがAndroidManifest.xml
ファイルの<application>
要素の下に作成されているかどうかを確認し、<meta-data>
ノードの名前が正しいかどうかを確認します。