ApsaraVideo VOD:クライアントアップロード

方式1：アップロード URL と認証情報 (推奨)

この方式は、よりシンプルな設定、動画ごとの権限制御による高いセキュリティ、より柔軟なレスポンスパラメータを提供します。大部分のクライアントアップロードシナリオに適しています。

ステージ1：アップロード URL と認証情報の取得

クライアントは、メディアメタデータ (Title、FileName、CateId、Tags など) を含む HTTP リクエストを AppServer に送信します。AppServer は、AK/SK を使用して ApsaraVideo VOD の CreateUploadVideo API を呼び出し、3 つの主要な値を取得します：UploadAuth (一時的なアップロードトークン)、UploadAddress (Base64 でエンコードされた OSS のターゲットパス)、VideoId (一意のメディア識別子)。AppServer はこれらをクライアントに転送します。

ステージ2：アップロードパラメータの構築とOSSへの直接アップロード

クライアントは、UploadAuth、UploadAddress、VideoId、およびローカルファイルパスを使用してアップロード SDK を初期化します。SDK は自動的に UploadAddress を解析して OSS エンドポイントとオブジェクトキーを取得し、ファイルを OSS に直接アップロードします。このプロセスは、マルチパートアップロードとレジュームアップロードをサポートしています。ファイルは、サーバーを経由せずにクライアントから OSS に直接転送されます。

ステージ3：アップロード結果

OSS がアップロードを完了すると、SDK は VideoId を含む onUploadSucceed コールバックをトリガーします。ApsaraVideo VOD は、アップロードの完了を自動的に検出し、設定された TemplateGroupId または WorkflowId に基づいてトランスコードと処理パイプラインをトリガーします。また、イベントコールバック (HTTP または MNS) を設定して、FileUploadComplete イベント通知を受信することもできます。

方式2：STS トークン

ステージ1：STS一時認証情報の取得

クライアントは、AppServer に一時認証情報をリクエストします。AppServer は、AK/SK を使用して STS の AssumeRole API を呼び出し、期限付きの AccessKeyId、AccessKeySecret、SecurityToken のセット (有効期限：900～3,600 秒) を取得し、それをクライアントに返します。

ステージ2：アップロード認証情報の取得とアップロード (SDKが自動処理)

クライアントは、STS トークンを使用してアップロード SDK を初期化します。SDK は自動的に STS トークンを使用して CreateUploadVideo (Title、FileName、その他のパラメータを含む) を呼び出し、UploadAuth、UploadAddress、VideoId を取得してから、マルチパートアップロードを自動的に実行します。このプロセス全体は開発者にとって透過的であり、手動で ApsaraVideo VOD API を呼び出す必要はありません。

ステージ3：アップロード結果

方式1と同様に、SDK は VideoId を含む onUploadSucceed をトリガーし、ApsaraVideo VOD はファイルを自動的に処理します。

マルチパートアップロード

マルチパートアップロードは、大きなファイルを小さなパートに分割し、並行してアップロードします。これにより、大きなメディアファイルのアップロード速度と信頼性の両方が向上します。ネットワーク障害が発生した場合でも、ファイル全体を再アップロードする必要はなく、失敗したパートのみを再試行すればよいためです。マルチパートアップロードは、すべてのクライアントアップロード SDK でデフォルトで有効になっており、追加の設定は必要ありません。

レジュームアップロード

レジュームアップロードを使用すると、SDK は、中断されたアップロードを最初から再開するのではなく、最後に正常にアップロードされたパートから続行できます。ネットワークの切断、アプリのバックグラウンド化、またはデバイスのスリープによってアップロードが中断された場合、SDK はチェックポイントデータを内部に保存します。接続が復元されてアプリが再開されると、SDK は開発者の介入なしにチェックポイントから自動的に再開します。

アップロード制御

アップロード SDK は、個々のアップロードを開始、停止、一時停止、再開するためのプログラムから制御するための API を提供します。これは、ユーザーが開始したアクション (ユーザーが別の画面に移動したときにアップロードをキャンセルするなど) に対応する必要がある場合や、バッチシナリオでアップロードの同時実行数を管理する場合に役立ちます。アップロードのライフサイクルは、SDK のメソッド呼び出しによって完全に制御できます。

進捗コールバック

SDK は、各ファイルのアップロード済みデータの割合を報告する詳細な進捗コールバックを公開します。これらのコールバックを使用して、プログレスバーの更新、アップロード速度の表示、またはアップロード中に特定の UI 要素を無効にするなどの条件付きロジックをトリガーできます。進捗コールバックは、アップロード中に定期的に実行され、転送ステータスをリアルタイムで確認できるようになります。

ネットワーク切り替え

モバイルクライアントは、Wi-Fi とモバイルネットワークの間を頻繁に切り替えます。SDK は、これらの切り替えを処理するために、アップロードの一時停止と再開をサポートしています。モバイルデータの消費を避けるために、デバイスがモバイルネットワークに切り替わったときに一時停止メソッドを呼び出し、Wi-Fi 接続が復帰したときに再開メソッドを呼び出します。アプリケーションは、ネットワーク切り替え検出ロジックを実装する必要があります。

一括アップロード

SDK は、複数のファイルの追加、削除、キャンセル、再開、走査をサポートするアップロードキューを管理します。キュー全体をクリアしたり、個々のエントリを操作したりできます。一括アップロードは、ユーザーが複数のメディアファイルを一度に選択するシナリオ (フォトギャラリーのアップロードなど) で役立ち、SDK は利用可能なリソースに基づいて、それらを順次または並行してスケジュールします。

メタデータサポート

アップロード認証情報を取得する際に、アップロードするメディアアセットにメタデータを付加できます。サポートされているメタデータフィールドには、Title、Tags、CateId、CoverURL、TemplateGroupId、WorkflowId が含まれます。認証情報を取得する段階でメタデータを設定することで、アップロード完了時にメディアアセットが正しいカテゴリ、タグ、処理ワークフローに即座に関連付けられ、メディアプロパティを更新するための個別の API 呼び出しが不要になります。

プライバシーコンプライアンス

クライアントアップロード SDK は、アプリストアを通じて配布されるアプリケーションに組み込まれるように設計されています。SDK は個人データを一切収集しません。SDK を組み込んだアプリを配布する際のコンプライアンス要件については、サービス契約をご参照ください。

課金

クライアントアップロード SDK 自体の使用は無料です。コストは、アップロード中および後に消費される ApsaraVideo VOD リソースに対して発生します。