すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo VOD:ショートビデオ SDK ライセンスの取得

最終更新日:Nov 21, 2025

ショートビデオ 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 以降の新規ユーザーの場合は、公式ドキュメントの指示に従って最新バージョンを統合してください。

  • Android 用 SDK の統合方法の詳細については、「SDK の初期化」をご参照ください。

  • iOS 用 SDK の統合方法の詳細については、「SDK の初期化」をご参照ください。

SDK のスペックアップ

3.29.0 より前のバージョンを統合している場合、ライセンスの有効期間内であれば、古いバージョンの SDK を引き続き使用できます。V3.29.0 以降にスペックアップする場合は、登録 API を呼び出して LicenseKey と LicenseFile を SDK に統合する必要があります。

  • Android 用 SDK の統合方法の詳細については、「SDK の初期化」をご参照ください。

  • iOS 用 SDK の統合方法の詳細については、「SDK の初期化」をご参照ください。

ライセンス権限付与

ステップ 1: アプリケーションの作成

  1. VOD コンソールの マイ権限 に移動し、[アプリケーション管理] タブを選択して、[アプリケーションの作成] をクリックします。image

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

    1. Web: [アプリケーション名][Web ドメイン名] を入力してアプリケーションを作成します。image

      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。

    2. モバイル: [アプリケーション名]、対応する Android の [パッケージ名]、iOS の [BundleID]、および [HarmonyOS BundleID] を入力してアプリケーションを作成します。

      image

      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 ハッシュのすべての文字を小文字に変換し、コロンを削除します。image.png

ステップ 2: ライセンスの購入

説明

すでにライセンスを購入している場合は、ステップ 3: ライセンスのアタッチ に進んでください。

  1. マイライセンス ページに戻り、[注文インスタンス] タブを選択して、[ライセンスの購入] をクリックします。image

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

    重要

    図に示すように、SDK 機能は個別にのみ購入できます。たとえば、Player SDK Standard Edition を単独で購入できます。image

  3. 支払いが成功したら、[注文インスタンス] タブに戻ります。新しく購入した注文インスタンスが表示されます。

ステップ 3: ライセンスのアタッチ

  1. マイ権限 ページに戻り、[ライセンス管理] タブを選択して、[ライセンスバインディング] をクリックします。image

  2. [ライセンスのアタッチ] ページで、アタッチするアプリケーションと対応する SDK ライセンス注文を選択します。情報を確認したら、[アタッチ] をクリックします。

    説明

    各ライセンス注文は、Web またはモバイルアプリケーションのいずれかである 1 つのアプリケーションにのみアタッチできます。

    image

  3. ライセンスがアタッチされたら、[ライセンス管理] タブに戻ります。アプリケーションの名前とその権限付与情報が表示されます。

ステップ 4: 権限付与情報の取得

  1. [ライセンス管理] タブで、ターゲットアプリケーションを見つけます。image

  2. 権限付与情報が正しいことを確認します。[証明書のダウンロード] をクリックして、ライセンス証明書ファイルをローカルマシンにダウンロードします。ライセンスをアプリケーションに統合するときに使用するために、ライセンスキーを保存します。ライセンスファイルの設定方法については、「ライセンスの統合」をご参照ください。

ライセンスの更新

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

ショートビデオ 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: ライセンス管理ページから更新する

  1. ApsaraVideo VOD コンソールの マイ権限 ページに移動します。

  2. [ライセンス管理] タブをクリックします。ターゲットアプリケーションにアタッチされているインスタンス ID を見つけて保存します。

    重要
    1. インスタンス ID が空であるか、更新中にエラーが発生した場合は、方法 2: 新しいライセンスを購入してアプリケーションにアタッチする を使用するか、チケットを送信 して更新する必要があります。

    2. 更新はライセンス注文全体に適用されます。ライセンス注文に複数の SDK 機能が含まれている場合、すべての機能がまとめて更新されます。更新中のスペックアップとスペックダウンはサポートされていません。ご不明な点がある場合は、チケットを送信 してください。

    image

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

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

方法 2: 新しいライセンスを購入してアプリケーションにアタッチする

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