ApsaraVideo VODでは、モバイルクライアントからApsaraVideo VODにメディアファイルを直接アップロードできます。 アプリケーションサーバーを使用してメディアファイルをアップロードする場合と比較して、クライアントからメディアファイルを直接アップロードすると、アプリケーションサーバーにファイルを送信したり、サーバーからファイルをアップロードしたりする必要がないため、サーバーリソースが節約されます。 このトピックでは、クライアントのアップロードSDKを使用できるシナリオと、クライアントのアップロードSDKの使用方法について説明します。
シナリオ
クライアントのアップロードSDKを使用して、ユーザー生成コンテンツ (UGC) と専門的に生成されたコンテンツ (PGC) をアップロードできます。 クライアントアップロードSDKを使用すると、ローカルファイルとオンラインファイルをアップロードできます。
Android用アップロードSDKでは、短いビデオをアップロードすることもできます。 VODSVideoUploadClientインスタンスを使用して、短いビデオとビデオのサムネイルを一度にアップロードできます。
機能 | 説明 | 補足 |
サポートされているクライアント | Web、iOS、Android、およびWeChatミニプログラム | なし。 |
サポートされているメディアファイル | アップロードできるメディアファイルの形式の詳細については、「サポートされているメディアファイル形式」をご参照ください。 ローカルファイルとオンラインファイルをアップロードできます。 オンラインファイルは、URLを使用してアップロードされます。 短いビデオを録画してアップロードできます。 一度に複数のファイルをアップロードし、ファイルリストを管理できます。 リストにファイルを追加または削除したり、ファイルのアップロードをキャンセルまたは再開したり、リストをトラバースまたはクリアしたりできます。 |
説明 URLを使用してメディアファイルをアップロードするには、URLをエンコードする必要があります。 これにより、URLの特殊文字によるアップロードの失敗を防ぎます。 |
ストレージアドレスの設定 | デフォルトのストレージアドレスを使用するか、ストレージアドレスを指定できます。 | デフォルトのストレージアドレスを変更できます。 詳細については、「VODストレージの管理」をご参照ください。 URLベースのアップロードは、中国 (上海) リージョンでのみサポートされています。 アップロードURLと資格情報を取得する操作を呼び出すときに、StorageLocationパラメーターを設定することで、ストレージアドレスを指定できます。 |
メディア資産管理 | タイトル、タグ、カテゴリ、サムネイルなど、メディアファイルのメタデータを設定できます。 | アップロードURLと資格情報を取得する操作を呼び出すときに、Title、Tags、CateId、CoverURLなどのパラメーターを設定してメタデータを設定できます。 |
オーディオとビデオのトランスコード | コード変換テンプレートまたはワークフローを指定して、アップロードされたオーディオおよびビデオファイルをコード変換できます。 トランスコードなしでオーディオおよびビデオファイルをアップロードすることもできます。 | アップロードURLと資格情報を取得する操作を呼び出すときに、TemplateGroupIdやWorkflowIdなどのパラメーターを設定してトランスコーディングを設定できます。 |
アップロードの制御 | アップロードを開始、停止、一時停止、および再開できます。 ApsaraVideo VODは再開可能なアップロードをサポートしています。 | 再開可能なアップロードは、アップロードSDKによって実装されます。 例外により動画のアップロードに失敗した場合は、アップロードが停止した時点からアップロードが再開されます。 |
イベント通知 | アップロードイベントの通知を受け取るようにコールバックを設定できます。 サポートされているイベント通知の詳細については、「設定のアップロード」をご参照ください。 | コールバックの設定方法の詳細については、「コールバックの設定」をご参照ください。 |
アップロード権限 |
| アップロード資格情報を使用してアップロード権限を付与することを推奨します。 詳細については、「資格情報とSTSの比較」をご参照ください。 |
アップロードの高速化 | この機能を使用するには、アップロードアクセラレーション機能を有効にする必要があります。 アップロードアクセラレーション機能を有効にするには、チケットを起票します。 | この機能を有効にした後、アップロードURLと資格情報を取得する操作を呼び出すときに、 |
ネットワーク切り替え | 3Gまたは4GモバイルネットワークとWi-Fiを切り替えることができます。 | 3Gまたは4Gネットワークでのデータ使用量を減らすために、ネットワークが3Gまたは4Gに切り替わったときにアップロードを一時停止し、ネットワークがWi-Fiに戻ったときにアップロードを再開できます。 ビジネス要件に基づいてネットワークタイプを指定する必要があります。 |
ApsaraVideo VODは、URLと資格情報のアップロードに関連する以下の操作を提供します。
プロセスのアップロード
クライアントアップロードSDKは、ファイルをOSSバケットにアップロードするロジックをカプセル化します。 クライアントからメディア・ファイルをアップロードすると、サーバーで転送することなく、ApsaraVideo VODによって割り当てられたOSSバケットにファイルが直接アップロードされます。 したがって、クライアントを認証する必要があります。 アップロードURLと資格情報を取得するには、アプリケーションサーバーに認証サービスを展開する必要があります。 クライアントのアップロードSDKは、アップロード資格情報に基づく承認とSTSトークンに基づく承認をサポートしています。 アップロード資格情報の使用を推奨します。 詳細については、「資格情報とSTSの比較」をご参照ください。
アップロードURLとアップロード資格情報を使用してメディアファイルをアップロードするプロセス
次の図は、アップロードURLとアップロード資格情報を使用してメディアファイルをアップロードする完全なプロセスを示しています。 この例では、ApsaraVideo VOD SDKを統合してアップロードURLと認証情報を取得します。
ユーザーは、ApsaraVideo VOD SDKなどのアプリケーションサーバーに認証サービスをデプロイして、アップロードURLと資格情報を取得します。
クライアントは、アップロードURLとアップロード資格情報を要求する要求をアプリケーションサーバーに送信します。
アプリケーションサーバーがApsaraVideo VODにリクエストを送信し、アップロードURLと資格情報をリクエストします。
ApsaraVideo VODはアップロードURLと資格情報を返します。
説明ApsaraVideo VODはメディアIDも生成し、メディアのライフサイクル管理とメディア処理で使用できます。
ビデオの場合、メディアIDは
VideoIdパラメーターで返されます。画像の場合、メディアIDは
ImageIdパラメーターで返されます。補助メディアアセットの場合、メディアIDは
MediaIdパラメーターで返されます。返されたメディアIDは、メディアアセット管理、オーディオおよびビデオの再生、メディア処理などの後続のタスクで必要となるものを適切に保持します。
アプリケーションサーバーは、アップロードURLと資格情報をクライアントに返します。
説明アプリケーションサーバーは、アップロードURLまたは資格情報に対してBase64デコードを実行する必要はありません。
クライアントは、アップロードURLと資格情報を使用して、アップロードインスタンスを初期化します。
クライアントはアップロードパラメータを構築してアップロード要求を送信する。
OSSはアップロード結果を返します。
説明事前にコールバックを設定して、アップロードイベントに関する通知を受け取ることもできます。
STSトークンを使用してメディアファイルをアップロードするプロセス
STSトークンに基づく権限付与を使用する場合は、RAMロールを作成し、ApsaraVideo VODにアクセスするための権限をRAMロールに付与する必要があります。 詳細については、「ロールを作成し、STSを使用してロールに一時的なアクセス許可を付与する」をご参照ください。
次の図は、STSトークンを使用してメディアファイルをアップロードする完全なプロセスを示しています。
ユーザーは、ApsaraVideo VOD SDKなどのアプリケーションサーバーに認証サービスをデプロイして、一時的なSTSトークンを取得します。
クライアントは、STSトークンを要求する要求をアプリケーションサーバーに送信します。
アプリケーションサーバーは、STSトークンを要求する要求をSTSに送信します。
STSはトークンを返します。
アプリケーションサーバーはSTSトークンをクライアントに返します。
クライアントはSTSトークンを使用してアップロードインスタンスを初期化します。
クライアントはアップロードパラメータを構築してアップロード要求を送信します。
OSSはアップロード結果を返します。
説明事前にコールバックを設定して、アップロードイベントに関する通知を受け取ることもできます。
関連ドキュメント
クライアントのアップロードSDKを統合して使用する手順は、クライアントによって異なります。 詳細については、以下のトピックをご参照ください。
WeChat miniプログラム用SDKのアップロード