アプリケーションサーバーからApsaraVideo VODに割り当てられたObject Storage Service (OSS) バケットにメディアファイルをアップロードできます。 ApsaraVideo VODは、一般的なプログラミング言語とデモ向けのサーバーアップロードSDKを提供します。 サーバーアップロードSDKは、アップロードURLと資格情報の取得に使用できるロジックをカプセル化します。 SDKを使用してアップロードを開始する前に、簡単な設定のみを実行する必要があります。 このトピックでは、サーバーアップロードSDKのシナリオ、アップロードプロセス、および使用方法について説明します。
シナリオ
自動アップロードを実行したり、大量の動画ファイルやオンラインメディアファイルをアップロードしたりする場合は、サーバーアップロードSDKを使用できます。 オンラインメディアファイルをアップロードするには、ファイルをアプリケーションサーバーにダウンロードしてから、アプリケーションサーバーからApsaraVideo VODにファイルをアップロードする必要があります。
機能 | 説明 | 補足 |
プログラミング言语 | Java、Python、PHP、C、およびC ++ がサポートされています。 | 他のプログラミング言語の場合は、OSS SDKを使用します。 詳細については、「OSS SDKを使用したメディアファイルのアップロード」をご参照ください。 |
サポートされているメディアファイル | サポートされているメディアファイル形式については、「サポートされているメディアファイル形式」をご参照ください。 ローカルファイルとオンラインファイルをアップロードできます。 オンラインファイルは、URLを使用してアップロードされます。 |
説明 URLを使用してメディアファイルをアップロードするには、URLをエンコードする必要があります。 これにより、URLの特殊文字によるアップロードの失敗を防ぎます。 |
ストレージアドレス | デフォルトのストレージアドレスを使用するか、ストレージアドレスを指定できます。 | デフォルトのストレージアドレスを変更できます。 詳細については、「VODストレージの管理」をご参照ください。 URLベースのアップロードは、中国 (上海) リージョンでのみサポートされています。 アップロードURLと資格情報を取得するためのAPI操作を呼び出すときに、StorageLocationパラメーターを設定することで、ストレージアドレスを指定できます。 |
内部ネットワークを介したアップロード | アップロードスクリプトをElastic Compute Service (ECS) インスタンスにデプロイする場合は、アップロードロジックでECSインスタンスが存在するリージョンを指定できます。 ECSインスタンスのリージョンがApsaraVideo VODのストレージリージョンと同じ場合、ファイルは内部ネットワーク経由で自動的にアップロードされます。 これにより、アップロードが加速され、インターネットトラフィックが削減されます。 | ApsaraVideo VOD APIは、パブリックドメイン名を使用してのみ呼び出すことができます。 アップロードスクリプトをデプロイするには、インターネットにアクセスできるECSインスタンスを使用する必要があります。 |
メディア資産管理 | メディアタイトル、タグ、カテゴリ、サムネイルなどのメディアメタデータを設定できます。 | アップロードURLと資格情報を取得する操作を呼び出すときに、Title、Tags、CateId、CoverURLなどのパラメーターを設定してメタデータを設定できます。 |
オーディオとビデオのトランスコード | コード変換テンプレートまたはワークフローを指定して、アップロードされたオーディオおよびビデオファイルをコード変換できます。 トランスコードなしでオーディオおよびビデオファイルをアップロードすることもできます。 | アップロードURLと資格情報を取得する操作を呼び出すときに、TemplateGroupIdやWorkflowIdなどのパラメーターを設定してトランスコーディングを設定できます。 |
アップロードの制御 | アップロードの進行状況バーを設定し、デフォルトまたはカスタムの進行状況コールバックを使用できます。 再開可能アップロード機能は、サーバーアップロードSDK for Javaでのみサポートされています。 他のプログラミング言語のサーバーアップロードSDKは、この機能をサポートしていません。 | M3U8ファイルのアップロードプログレスバーは設定できません。 |
イベント通知 | アップロードイベントの通知を受け取るようにコールバックを設定できます。 サポートされているイベント通知の詳細については、「設定のアップロード」をご参照ください。 | コールバックの設定方法の詳細については、「コールバックの設定」をご参照ください。 |
アップロード権限 | アップロード資格情報を使用して、アップロード権限を付与できます。 この場合、アップロードインスタンスを初期化するには、Alibaba Cloudアカウントまたは許可されたRAMユーザーのAccessKeyペアを使用する必要があります。 セキュリティトークンサービス (STS) トークンを使用して、アップロード権限を付与することもできます。 この場合、STSトークンを使用してアップロードインスタンスを初期化する必要があります。 | STSトークンを使用してアップロード権限を付与する場合、STSトークンを取得するためのサービスをデプロイする必要があります。 |
アップロードの高速化 | この機能を使用するには、アップロードアクセラレーション機能を有効にする必要があります。 アップロードアクセラレーション機能を有効にするには、チケットを起票する必要があります。 | この機能を有効にした後、アップロードURLと資格情報を取得する操作を呼び出すときに、 |
ApsaraVideo VODは、次のアップロードURLと資格情報の取得に使用されるAPI操作を提供します。
アップロードのプロセス
サーバーアップロードSDKは、アップロードURLと資格情報の取得に使用できるロジックとOSSアップロードロジックをカプセル化します。 SDKを使用してアップロードを開始する前に、簡単な設定のみを実行する必要があります。 次の図は、完全なアップロード処理を示しています。
アップロードプロセス
サーバーアップロードSDKをアプリケーションサーバーに統合し、アップロード設定を完了します。 たとえば、AccessKeyペア、ファイルパス、ストレージアドレス、メディアアセット情報、トランスコード設定、アップロードコントロール設定を設定します。
アプリケーションサーバーは、サーバーアップロードSDKを使用してAPI操作を呼び出し、アップロードURL、アップロードクレデンシャル、およびメディアアセット情報を取得します。
説明または、HTTPまたはHTTPSリクエストを作成して、アップロードURLと資格情報を取得することもできます。 ただし、この方法では署名を作成する必要があり、エラーが発生する可能性があります。 ApsaraVideo VODは、次のURLと資格情報のアップロードに関する操作を提供します。
ApsaraVideo VODは、アップロードURL、アップロード資格情報、およびメディアIDをアプリケーションサーバーに返します。
説明ApsaraVideo VODは、アップロードURLと資格情報を返すとメディアIDを生成します。 メディアIDは、ライフサイクル管理とメディア処理に使用されます。
ビデオの場合、メディアIDは
VideoIdパラメーターで返されます。画像の場合、メディアIDは
ImageIdパラメーターで返されます。補助メディアアセットの場合、メディアIDは
MediaIdパラメーターで返されます。メディアアセット管理、オーディオとビデオの再生、メディア処理などの後続のタスクに必要な、返されたメディアIDを記録します。
アプリケーションサーバーは、サーバーアップロードSDKによってカプセル化されたOSSアップロードロジックに基づいてアップロードを開始します。
OSSクライアントはアップロード結果を返します。
説明アップロード結果をリッスンするように事前にコールバックを設定することもできます。
関連ドキュメント
サーバーアップロードSDKを統合して使用する手順は、プログラミング言語によって異なります。 サーバーアップロードSDKを統合して使用する方法の詳細については、以下のトピックを参照してください。
サーバーアップロードSDKとサーバー操作SDKの違い
ApsaraVideo VODが提供するサーバーアップロードSDKとサーバー操作SDKは異なります。 サーバーアップロードSDKは、完全なアップロードロジックをカプセル化します。 アップロードSDKを統合してアップロードを開始できます。 サーバー操作SDKは、ApsaraVideo VODのすべての機能を統合します。 アップロード機能の場合、サーバー操作SDKは、アップロードURLと資格情報を取得するロジックのみをカプセル化します。 サーバー操作SDKを使用してメディアファイルをアップロードする場合は、アップロードロジックを開発する必要があります。 たとえば、ApsaraVideo VODからアップロードURLと資格情報を取得し、Base64-encodedアップロードURLと資格情報をデコードし、OSSを使用してファイルをアップロードする必要があります。 ApsaraVideo VODのサーバー操作SDKの詳細については、 「サーバーSDKリファレンス」をご参照ください。