アプリケーションサーバーから、ApsaraVideo VODによって割り当てられたObject Storage Service (OSS) バケットにメディアファイルをアップロードできます。 ApsaraVideo VODは、一般的なプログラミング言語向けのサーバーアップロードSDKと、これらのSDKの使用方法に関するデモを提供します。 サーバーアップロードSDKは、アップロードURLと資格情報を取得するロジックをカプセル化します。 簡単な設定のみを設定する必要があり、SDKを使用してアップロードを開始できます。 このトピックでは、サーバーアップロードSDKのシナリオ、アップロードプロセス、および統合と使用方法について説明します。
シナリオ
自動アップロードが必要な場合や、大量の動画ファイルやオンラインメディアファイルをアップロードする場合に、サーバーアップロードSDKを使用できます。 オンラインメディアファイルをアップロードするには、ファイルをアプリケーションサーバーにダウンロードしてから、アプリケーションサーバーからApsaraVideo VODにファイルをアップロードする必要があります。
| 機能 | 説明 | 補足 |
|---|---|---|
| プログラミング言语 |
Java、Python、PHP、およびCまたはC ++ がサポートされています。 |
他のプログラミング言語の場合は、OSS SDKを使用します。 詳細については、「OSS SDKを使用したメディアファイルのアップロード」をご参照ください。 |
| メディアファイル |
サポートされているメディアファイル形式の詳細については、「サポートされているメディアファイル形式」をご参照ください。 ローカルメディアファイルとオンラインメディアファイルをアップロードできます。 オンラインメディアファイルは、URLベースのアップロードのみをサポートします。 |
注
URLを使用してファイルをアップロードする前に、URLをエンコードする必要があります。 これにより、URL内の特殊文字によるアップロードの失敗を防ぐことができる。 |
| 保管場所 |
デフォルトの保存場所を使用するか、保存場所を指定できます。 |
デフォルトの保存場所を変更できます。 詳細については、「VODストレージの管理」をご参照ください。 URLベースのアップロードは、中国 (上海) リージョンでのみサポートされています。 保存場所を指定するには、アップロードURLとアップロード資格情報を取得する操作でStorageLocationパラメーターを設定します。 |
| 内部ネットワークを介したアップロード |
ECS (Elastic Compute Service) インスタンスにアップロードスクリプトをデプロイする必要がある場合は、アップロードロジックでECSインスタンスが存在するリージョンを指定できます。 ECSインスタンスのリージョンがApsaraVideo VODのストレージリージョンと同じ場合、ファイルは内部ネットワーク経由で自動的にアップロードされます。 This speeds up uploads and reduces Internet traffic. |
ApsaraVideo VODは、APIを使用するためのパブリックエンドポイントのみを提供します。 Therefore, you must use an ECS instance that can access the Internet to deploy the upload script. |
| メディア管理 |
タイトル、タグ、カテゴリID、サムネイルなど、メディアファイルのメタデータを設定できます。 |
アップロードURLと資格情報を取得するために使用する操作で、Title、Tags、CateId、CoverURLなどのパラメーターを設定することで、メディアファイルのメタデータを設定できます。 |
| オーディオとビデオのトランスコード |
コード変換テンプレートまたはワークフローを指定して、アップロードされたオーディオおよびビデオファイルをコード変換できます。 トランスコードなしでオーディオおよびビデオファイルをアップロードすることもできます。 |
アップロードURLと資格情報の取得に使用する操作で、TemplateGroupIdやWorkflowIdなどのパラメーターを設定することで、トランスコードを設定できます。 |
| アップロードの制御 |
アップロードの進行状況バーを設定し、デフォルトおよびカスタムの進行状況コールバックを使用できます。 Java用のサーバーアップロードSDKは再開可能なアップロードをサポートしていますが、他のプログラミング言語用のサーバーアップロードSDKはサポートしていません。 |
You cannot configure the upload progress bar for M3U8 files. |
| イベント通知 |
アップロードイベントに関する通知を受け取るようにコールバックを設定できます。 For more information about supported event notifications, see 設定のアップロード. |
For more information about how to configure callbacks, see t1959253.html#multiTask428. |
| アップロード権限 |
アップロード認証には、アップロード資格情報を使用できます。 具体的には、Alibaba Cloudアカウントまたは許可されたRAMユーザーのAccessKeyペアを使用して、アップロードインスタンスを初期化できます。 セキュリティトークンサービス (STS) トークンを使用してアップロードを許可できます。 具体的には、STS AccessKeyペアを使用してアップロードインスタンスを初期化できます。 |
STSトークンをアップロード認証に使用するには、サービスを作成し、STS AccessKeyペアを取得する必要があります。 |
| アップロードの高速化 |
Upload acceleration is supported after you enable the upload acceleration feature. この機能を有効にするには、チケットを起票してください。 |
After you enable the feature, you can configure acceleration by setting the |
アップロードのプロセス
説明
-
You need to integrate a server upload SDK into your application server and complete the upload settings. For example, you need to configure the AccessKey pair, file path, storage location, media asset information, transcoding settings, and upload control settings.
-
The application server uses the server upload SDK to call an operation to obtain an upload URL, an upload credential, and media asset information.注 または、HTTPまたはHTTPSリクエストを作成して、アップロードURLと資格情報を取得することもできます。 However, this method requires you to construct a signature and may easily cause errors. ApsaraVideo VODは、次の操作を使用してアップロードURLと資格情報を取得します。
-
ApsaraVideo VODは、アップロードURLと資格情報、およびメディアIDをアプリケーションサーバーに配信します。注
ApsaraVideo VODは、アップロードURLと資格情報に加えて、メディア処理またはメディアアセットのライフサイクル管理のためにメディアIDを自動的に作成します。
- アップロードするメディアアセットがビデオの場合、ApsaraVideo VODは
VideoIdパラメーターでメディアIDを返します。 - アップロードするメディアアセットが画像の場合、ApsaraVideo VODは
ImageIdパラメーターでメディアIDを返します。 - アップロードするメディアアセットが補助メディアアセットの場合、ApsaraVideo VODは
MediaIdパラメーターでメディアIDを返します。 - メディアIDは、メディア資産管理、オーディオおよびビデオ再生、およびメディア処理に使用されます。 Keep the media ID safe.
- アップロードするメディアアセットがビデオの場合、ApsaraVideo VODは
-
アプリケーションサーバーは、サーバーアップロードSDKによってカプセル化されたOSSアップロードロジックに基づいてアップロードを開始します。
- OSSはアップロード結果を返します。
注 事前にコールバックを設定して、アップロード結果をリッスンすることもできます。
関連ドキュメント
サーバーアップロードSDKとサーバー操作SDKの違い
ApsaraVideo VODが提供するサーバーアップロードSDKとサーバー操作SDKは異なります。 サーバーアップロードSDKは、完全なアップロードロジックをカプセル化します。 アップロードSDKを統合してアップロードを開始できます。 The server operation SDKs integrate all features of ApsaraVideo VOD. In terms of the upload feature, the server operation SDKs encapsulate only the logic to obtain an upload URL and credential. サーバー操作SDKを使用する場合は、アップロードロジックを開発する必要があります。 たとえば、ApsaraVideo VODからアップロードURLと資格情報を取得し、Base64-encodedアップロードURLと資格情報をデコードし、OSS機能を使用してアップロードを完了する必要があります。 ApsaraVideo VODが提供するサーバー操作SDKの詳細については、「」「サーバー操作SDKリファレンス」をご参照ください。