ショートビデオ SDK は、権限付与のためにライセンスを必要とします。このトピックでは、ショートビデオ SDK のライセンスを取得して使用する方法について説明します。
ライセンスサービスの更新
V3.29.0 以降、ショートビデオ SDK は ApsaraVideo MediaBox SDK ライセンスサービスを使用します。ApsaraVideo MediaBox SDK ライセンスは、Push SDK、ショートビデオ SDK、ApsaraVideo Player SDK、Queen SDK などの SDK に権限を付与します。ライセンスはアプリケーションにバインドされます。1 つのライセンスを 1 つの Android アプリケーションと 1 つの iOS アプリケーションにバインドできます。この更新に伴い、ショートビデオ SDK の統合方法も変更されます。
ショートビデオ SDK バージョン | 統合方法 |
新規統合 | V3.29.0 以降の新規ユーザーの場合は、公式ドキュメントの指示に従って最新バージョンを統合してください。 |
SDK のスペックアップ | 3.29.0 より前のバージョンを統合している場合、ライセンスの有効期間内であれば、古いバージョンの SDK を引き続き使用できます。V3.29.0 以降にスペックアップする場合は、登録 API を呼び出して LicenseKey と LicenseFile を SDK に統合する必要があります。 |
ライセンス権限付与
ステップ 1: アプリケーションの作成
VOD コンソールの マイ権限 に移動し、[アプリケーション管理] タブを選択して、[アプリケーションの作成] をクリックします。

アプリケーション情報を編集します。アプリケーションは、[プラットフォームタイプ] (Web とモバイル) によって分類されます。
Web: [アプリケーション名] と [Web ドメイン名] を入力してアプリケーションを作成します。

Web ドメイン名に関する注意
標準フォーマットの例: aliyun.com。
重要pc.aliyun.com や mobile.aliyun.com などの複数のサブドメインをカバーするには、プライマリドメイン名 aliyun.com のみを入力します。
不正なフォーマットの例 (以下のフォーマットは使用しないでください):
プロトコルを含む: http://aliyun.com または https://aliyun.com。
パスまたはサブページを含む: aliyun.com/index または aliyun.com/login。
ワイルドカードドメイン名を使用する: *.aliyun.com または .aliyun.com。
モバイル: [アプリケーション名]、対応する Android の [パッケージ名]、iOS の [BundleID]、および [HarmonyOS BundleID] を入力してアプリケーションを作成します。

Android アプリケーション署名のアタッチ
説明[プラットフォームタイプ] で Android を選択し、[署名をアタッチ] を選択した場合、このフィールドは必須です。
署名をアタッチすると、セキュリティが向上し、同じパッケージ名を持つ他のアプリケーションによってライセンスが使用されるのを防ぐことができます。
新しい SDK バージョンでは、署名をアタッチする必要はありません。これには、MediaBox オーディオおよびビデオ SDK v1.7.0 以降、Player SDK v5.5.2 以降、Push SDK v4.4.9 以降、およびショートビデオ SDK v3.36.0 以降が含まれます。
次の 2 つの方法のいずれかで、Android アプリケーション署名の MD5 ハッシュを取得します。
コマンドラインから:
keytool -v -list -keystore your.keystoreを実行して、対応する署名の MD5 ハッシュを表示します。Android Studio から: 右側のサイドバーで、Gradle をクリックします。対応するアプリを見つけて、Tasks > android > signingReport に移動してハッシュを取得します。MD5 ハッシュのすべての文字を小文字に変換し、コロンを削除します。

ステップ 2: ライセンスの購入
すでにライセンスを購入している場合は、ステップ 3: ライセンスのアタッチ に進んでください。
マイライセンス ページに戻り、[注文インスタンス] タブを選択して、[ライセンスの購入] をクリックします。

オーディオおよびビデオターミナル SDK 購入ページで、必要に応じて SDK とその機能モジュールを選択します (SDK 機能は組み合わせて購入できません)。選択内容を確認したら、ライセンスを購入します。
重要図に示すように、SDK 機能は個別にのみ購入できます。たとえば、Player SDK Standard Edition を単独で購入できます。

支払いが成功したら、[注文インスタンス] タブに戻ります。新しく購入した注文インスタンスが表示されます。
ステップ 3: ライセンスのアタッチ
マイ権限 ページに戻り、[ライセンス管理] タブを選択して、[ライセンスバインディング] をクリックします。

[ライセンスのアタッチ] ページで、アタッチするアプリケーションと対応する SDK ライセンス注文を選択します。情報を確認したら、[アタッチ] をクリックします。
説明各ライセンス注文は、Web またはモバイルアプリケーションのいずれかである 1 つのアプリケーションにのみアタッチできます。

ライセンスがアタッチされたら、[ライセンス管理] タブに戻ります。アプリケーションの名前とその権限付与情報が表示されます。
ステップ 4: 権限付与情報の取得
[ライセンス管理] タブで、ターゲットアプリケーションを見つけます。

権限付与情報が正しいことを確認します。[証明書のダウンロード] をクリックして、ライセンス証明書ファイルをローカルマシンにダウンロードします。ライセンスをアプリケーションに統合するときに使用するために、ライセンスキーを保存します。ライセンスファイルの設定方法については、「ライセンスの統合」をご参照ください。
ライセンスの更新
ライセンスの有効期限切れの確認
ショートビデオ SDK ライセンスには有効期限があります。ライセンスが有効期限切れかどうかを判断する基準は、SDK のバージョンによって異なります。
3.29.0 より前のバージョン:
値
ALIVC_FRAMEWORK_LICENSE_FAILED(-10011001)が返されます。ログに次のいずれかのメッセージが表示されます。
30 日間ネットワークがありません。ライセンスは無効になっています。更新するか、新しい権限付与を取得してください。
ライセンスは無効になっています。更新するか、新しい権限付与を取得してください。
ライセンスは無効です (パッケージ名と署名/BundleID がショートビデオ SDK の公式サイトに登録されていません)。7 日間のトライアルは終了し、ライセンスは無効になっています。
V3.29.0 以降:
値
ALIVC_FRAMEWORK_LICENSE_FAILED(-10011001)が返されます。ログに次のいずれかのメッセージが表示されます。
ライセンスの有効期限が切れています。更新するか、新しい権限付与を取得してください。
ライセンスが初期化されていません。詳細については、「SDK の初期化 (Android)」または「SDK の初期化 (iOS)」をご参照ください。
ライセンスは無効です (パッケージ名と署名/BundleID がショートビデオ SDK の公式サイトに登録されていません)。新しい権限付与を取得してください。
付加価値サービス: xxx の有効期限が切れています。更新するか、新しい権限付与を取得してください。(xxx は特定の付加価値サービスを示します。)
付加価値サービス: xxx は無効です。使用する前に、対応する付加価値サービスのライセンスを取得してください。(xxx は特定の付加価値サービスを示します。)
ライセンス更新方法
方法 1: ライセンス管理ページから更新する
ApsaraVideo VOD コンソールの マイ権限 ページに移動します。
[ライセンス管理] タブをクリックします。ターゲットアプリケーションにアタッチされているインスタンス ID を見つけて保存します。
重要インスタンス ID が空であるか、更新中にエラーが発生した場合は、方法 2: 新しいライセンスを購入してアプリケーションにアタッチする を使用するか、チケットを送信 して更新する必要があります。
更新はライセンス注文全体に適用されます。ライセンス注文に複数の SDK 機能が含まれている場合、すべての機能がまとめて更新されます。更新中のスペックアップとスペックダウンはサポートされていません。ご不明な点がある場合は、チケットを送信 してください。

費用とコストコンソールの 更新 ページに移動します。保存したインスタンス ID を使用して注文を検索します。注文を見つけて、[アクション] 列の [更新] をクリックします。

オーディオおよびビデオターミナル SDK の更新ページで、現在の構成とサブスクリプション期間を確認します。次に、[今すぐ購入] をクリックして更新を完了します。有効期限切れのライセンスによるサービス中断を防ぐために、[自動更新] を選択することをお勧めします。

方法 2: 新しいライセンスを購入してアプリケーションにアタッチする
SDK ライセンスを購入したものの、対応する注文インスタンス ID が空であるか、更新中にエラーが発生した場合は、現在のライセンスが有効期限切れになる前に MediaBox オーディオおよびビデオ SDK ページから新しいライセンスを購入する必要があります。購入後、新しいライセンスをアタッチ して、SDK 呼び出しの失敗によるビジネスの中断を防ぎます。