動画編集 API とは?
動画編集 API は、トリミング、連結、オーバーレイ、トランジション、音声ミキシング、タイムラインのレンダリングをプログラムから操作できるようにします。アプリケーションは、担当者がデスクトップ編集ソフトを操作しなくても、編集結果を作成できます。
動画編集 API の仕組み
編集サービスは通常、素材を参照し、トラックの配置、トリミング、エフェクト、出力設定を記述した宣言的なタイムラインを受け取ります。サービスは参照先を解決し、レンダーグラフを構築して、バックグラウンドワーカーで一つ以上の派生ファイルを生成します。再生専用 API とは異なり、新しいメディアを作成するため、動画、音声、グラフィックス、字幕の間でタイミングを維持する必要があります。自動化された制作ワークフローでは、素材管理と配信用パッケージングの間に位置します。
要点
- タイムラインの値には、明示的な単位と丸め方針が必要です。秒、フレーム、トラックのタイムベースを混在させると、カットやオーバーレイの位置が出力の一フレーム以上ずれる場合があります。
- 素材への参照は、不変にするかバージョンを固定するべきです。同じ URL の素材を置き換えると、それまで再現可能だった編集でも、異なる内容がレンダリングされる場合があります。
- 長時間のレンダリングには、永続的なジョブ識別子、冪等な送信、照会可能なステータスが必要です。クライアントが切断される場合や、完了コールバックが遅延または重複する場合があるためです。
動画編集 API が重要になる場面
テンプレート、パーソナライズされた動画、繰り返し実行できるハイライト生成には、編集 API を使用してください。統合にあたっては、タイムラインの精度、コーデック対応、レンダリングの遅延、非同期処理の失敗への対処を判断基準にするべきです。