ApsaraVideo VODを使用すると、モバイル端末からApsaraVideo VODによって割り当てられたObject Storage Server (OSS) バケットにメディアファイルをアップロードできます。 ApsaraVideo VODは、クライアントのアップロードSDKとデモを提供します。 このトピックでは、クライアントのアップロードSDKを使用できるシナリオと、クライアントのアップロードSDKの使用方法について説明します。

シナリオ

クライアントのアップロードSDKは、ユーザー生成コンテンツ (UGC) および専門的に生成されたコンテンツ (PGC) をアップロードするシナリオで使用できます。 クライアントアップロードSDKは、ローカルおよびオンラインファイルのアップロードをサポートします。
注 Android用アップロードSDKは、短いビデオのアップロードもサポートしています。 VODSVideoUploadClientインスタンスを使用して、短いビデオとビデオのサムネイルを一度にアップロードできます。
機能 説明 補足
サポートされているクライアント

Web、iOS、Android、およびWeChatミニプログラム

N/A
サポートされているメディアファイル

アップロードできるメディアファイルの形式の詳細については、「サポートされているメディアファイル形式」をご参照ください。

ローカルファイルとオンラインファイルをアップロードできます。 オンラインファイルは、ソースファイルのURLを使用してアップロードされます。

短いビデオを録画してアップロードできます。

一度に複数のファイルをアップロードし、ファイルリストを管理できます。 リストにファイルを追加または削除したり、ファイルのアップロードをキャンセルまたは再開したり、リストをトラバースまたはクリアしたりできます。

  • 最大48.8テラバイトのローカルメディアファイルをアップロードできます。
  • 最大5 GBのオンラインメディアファイルをアップロードできます。
注

URLを使用してメディアファイルをアップロードするには、URLをエンコードする必要があります。 これにより、URLの特殊文字によるアップロードの失敗を防ぎます。

保管場所

SDKをアップロードすると、デフォルトまたは指定された保存場所を使用できます。

デフォルトの格納場所は変更できます。 詳細については、「VODストレージの管理」をご参照ください。

URLベースのアップロードは、中国 (上海) リージョンでのみサポートされています。

URLと資格情報のアップロードに関連する操作を呼び出すときに、StorageLocationパラメーターを設定して、保存場所を指定できます。
メディア資産管理

メディアタイトル、タグ、カテゴリ、サムネイルなどのメディアメタデータを設定できます。

URLと資格情報のアップロードに関連する操作を呼び出すときに、Title、Tags、CateId、CoverURLなどのパラメーターを設定することで、メディアメタデータを管理できます。
オーディオとビデオのトランスコード

コード変換テンプレートまたはワークフローを指定できます。

メディアファイルをトランスコードしないこともできます。

URLと資格情報のアップロードに関連する操作を呼び出すときに、TemplateGroupIdやWorkflowIdなどのパラメーターを設定してトランスコーディングを設定できます。
アップロード管理

アップロードを開始、停止、一時停止、および再開できます。

ApsaraVideo VODは再開可能なアップロードをサポートしています。

再開可能なアップロードは、アップロードSDKによって実装されます。 例外によりビデオのアップロードに失敗した場合、アップロードは停止した場所から再開されます。
イベントの通知

コールバックを設定して、アップロードイベントに関する通知を取得できます。 サポートされるイベント通知の詳細については、「設定のアップロード」をご参照ください。

コールバックの設定方法の詳細については、「t1959253.html#multiTask428」をご参照ください。
アップロード権限

アップロード資格情報を使用して、アップロード権限を付与できます。 この場合、アップロードインスタンスを初期化するには、Alibaba Cloudアカウントまたは許可されたRAMユーザーのAccessKeyペアを使用する必要があります。

セキュリティトークンサービス (STS) トークンを使用して、アップロード権限を付与することもできます。 この場合、STSトークンを使用してアップロードインスタンスを初期化する必要があります。

モバイル端末またはwebでアップロードSDKを使用する場合は、STSトークンを使用してアップロード権限を付与することを推奨します。

STSトークンを使用してアップロード権限を付与する場合、STSトークンを取得するためのサービスをデプロイする必要があります。

クライアントアップロードSDKは、STSトークンを更新するサンプルコードを提供します。

アップロードの高速化

この機能を使用するには、アップロードアクセラレーション機能を有効にする必要があります。 この機能を有効にするには、チケットを起票してください。

この機能を有効にした後、URLと資格情報のアップロードに関連する操作を呼び出すときに、UserDataパラメーターでAccelerateConfigパラメーターを設定して、この機能を構成できます。

ネットワークタイプの切り替え

3Gまたは4GモバイルネットワークとWi-Fiを切り替えることができます。

3Gまたは4Gネットワークでのデータ使用量を減らすために、ネットワークが3Gまたは4Gに切り替わったときにアップロードを一時停止し、ネットワークがWi-Fiに戻ったときにアップロードを再開できます。 ネットワークタイプは自分で特定する必要があります。

注 ApsaraVideo VODは、次のURLと資格情報のアップロードに関する操作を提供します。

プロセスのアップロード

クライアントアップロードSDKは、ファイルをOSSバケットにアップロードするロジックをカプセル化します。 クライアントからメディア・ファイルをアップロードすると、サーバーで転送することなく、ApsaraVideo VODによって割り当てられたOSSバケットにファイルが直接アップロードされます。 したがって、クライアントを認証する必要があります。 アップロードURLと資格情報を取得するには、アプリケーションサーバーに認証サービスを展開する必要があります。 クライアントのアップロードSDKは、次の権限付与方法をサポートします。
  • アップロードURLと資格情報に基づく承認。 ApsaraVideo VODのサーバー操作SDKを使用して、アップロードURLと資格情報を取得することを推奨します。
  • STSトークンに基づく権限付与。 この方法を使用する場合は、指定した権限を持つRAMロールを作成し、RAMロールをRAMユーザーに割り当て、STS権限付与サービスをデプロイする必要があります。

アップロードURLとアップロード資格情報を使用してメディアファイルをアップロードするプロセス

  1. ユーザーは、ApsaraVideo VODサーバー操作SDKなどの認証サービスをアプリケーションサーバーにデプロイして、アップロードURLと資格情報を取得します。
  2. クライアントは、アップロードURLとアップロード資格情報を要求する要求をアプリケーションサーバーに送信します。
  3. アプリケーションサーバーがApsaraVideo VODにリクエストを送信し、アップロードURLと資格情報をリクエストします。
  4. ApsaraVideo VODはアップロードURLと資格情報を返します。
    注

    ApsaraVideo VODはメディアIDも生成し、メディアのライフサイクル管理とメディア処理で使用できます。

    • ビデオの場合、メディアIDはVideoIdパラメーターで返されます。
    • 画像の場合、メディアIDはImageIdパラメーターで返されます。
    • 補助メディアアセットの場合、メディアIDはMediaIdパラメーターで返されます。
    • メディアIDを安全に保持していることを確認してください。 メディアアセット管理、オーディオまたはビデオの再生、メディア処理などのシナリオで必要になります。
  5. アプリケーションサーバーは、アップロードURLと資格情報をクライアントに返します。
    重要 アプリケーションサーバーは、アップロードURLまたは資格情報に対してBase64デコードを実行する必要はありません。
  6. クライアントは、アップロードURLと資格情報を使用して、アップロードインスタンスを初期化します。
  7. クライアントはアップロードパラメータを構築してアップロード要求を送信する。
  8. OSSはアップロード結果を返します。
    注 事前にコールバックを設定して、アップロードイベントに関する通知を受け取ることもできます。

STSトークンを使用してメディアファイルをアップロードするプロセス

  1. ユーザーは、ApsaraVideo VODサーバー操作SDKなどの認証サービスをアプリケーションサーバーにデプロイして、一時的なSTSトークンを取得します。
  2. クライアントは、STSトークンを要求する要求をアプリケーションサーバーに送信します。
  3. アプリケーションサーバーは、STSトークンを要求する要求をSTSに送信します。
  4. STSはSTSトークンを返します。
  5. アプリケーションサーバーはSTSトークンをクライアントに返します。
  6. クライアントはSTSトークンを使用してアップロードインスタンスを初期化します。
  7. クライアントはアップロードパラメータを構築してアップロード要求を送信する。
  8. OSSはアップロード結果を返します。
    注 事前にコールバックを設定して、アップロードイベントに関する通知を受け取ることもできます。

関連ドキュメント

クライアントのアップロードSDKを統合して使用する手順は、クライアントによって異なります。 さまざまな種類のSDKを使用する方法の詳細については、次のトピックを参照してください。