動画処理 API とは?
動画処理 API は、トランスコーディング、リサイズ、切り抜き、解析、パッケージ化、サムネイル生成をプログラムから実行するための機能を提供します。大規模な変換は一般に、単一のリクエスト内で完了するのではなく、非同期タスクとして送信されます。
動画処理 API の仕組み
処理 API はメディア操作をリモートのタスクグラフに変換し、入力、パラメーター、出力をクライアント接続とは独立して追跡できるようにします。ワーカーがソースを調査し、適合する変換をスケジュールし、派生ファイルを保存して、最終状態や中間状態を報告します。編集用のタイムラインを使わずに正規化、解析、パッケージ化、品質チェックも行う場合は、編集 API より広い範囲を扱います。このサービスは、取り込みとアセット管理の後、公開や再生の前に位置します。
要点
- 冪等性キーがネットワークの再試行によるタスクや課金の重複、同じ出力先への競合する書き込みを防ぐのは、API が冪等性キーを実装している場合に限られます。そうでない場合は、呼び出し元が独自のリクエスト識別情報を使って、送信の重複を排除する必要があります。
- 完了コールバックは重複して届いたり、到着順が入れ替わったりする可能性があるため、認証を行い、再実行しても安全な設計にする必要があります。状態の整合性を確認するために、ステータスエンドポイントも引き続き必要です。
- サービスのアップグレード後は、同じ上位レベルのパラメーターでも異なるバイト列が生成される場合があります。各出力とともにプロセッサー、コーデック、プリセットのバージョンを記録すると、再現性の確保に役立ちます。
動画処理 API が重要になる場面
処理 API を使い、アップロードされたマスターファイルからアプリケーションで使えるメディアを自動生成してください。タスクは長時間実行されたり重複したりする可能性があるため、再試行、冪等性、ステータスコールバック、部分的な失敗を考慮して設計してください。