vmake-video-remove-watermark

動画のウォーターマークを削除する

機能と準備

ウォーターマークの削除には video-remove-auto を使用します。このサービスは削除対象のコンテンツを自動的に特定し、フレームを修復します。入力と目的が明確な場合は、既存の許可の範囲内で作業を進めてください。比較用に元のファイルを保持し、要素の保持や領域の制御を求められた場合は、セットアップのリファレンスを確認してください。

現在の CLI でサポートされているパラメーターを使用し、詳細はヘルプまたはコントラクトを参照してください。vmake-labs-cli が必要です。対象バージョンは 0.1.11 で、>=0.1.11 <0.2.0 と互換性があります。

最初に実行する前に、CLI のセットアップを読み、実行ファイルを特定して、そのバージョンと tool video-remove-auto --help を確認してください。JSON フィールドやメディアの制限が不明な場合は、該当する vmake contracts の項目を照会してください。出力の解析、サービスに関する質問、または実行の中断については、ランタイムと復旧を読んでください。

入力の収集

1. リクエストまたは添付ファイルから、実際の動画ファイルまたは URL を1つ取得します。明確な場合は再度尋ねないでください。候補が複数あり、どれか不明な場合はユーザーに選択を求めます。複数の入力を処理するのは許可されている場合に限り、各入力の記録を保持してください。
2. ローカル入力には、実際に読み取り可能なパスを使用します。リモートの元ファイルは CLI のセットアップに従ってダウンロードし、その後、ローカルファイルを送信してください。メディア ID しかない場合は、まずセッションを照会して実際の URL を取得します。ダウンロードに失敗した場合は、元のローカルファイルを求めてください。
3. タスクを続行するには -r '<session_id>' を追加し、新規タスクの場合は省略します。デフォルト、認証、不足情報については CLI のセットアップに従ってください。オプションパラメーターは現在のヘルプを参照し、指定されていない値は省略してください。
4. 復旧に備えて、元のソース、ローカルパス、セッションを保持してください。ユーザーからダウンロード済みのファイルが提供された場合は、確立済みの目的に沿って続行します。失敗した出力をソースとして扱わないでください。

アップロードと送信

特定した実行ファイルを使用し、準備したローカルファイルを個別の引数として指定します。

vmake tool video-remove-auto --video-file '<local-video-path>'

CLI はファイルを検証し、組み込みのアップロードパイプラインを通じてアップロードして CDN URL を取得した後、タスクを送信して監視します。先に create-room または add-media を呼び出したり、プレースホルダーのメディア参照を構築したりしないでください。パラメーターファイルと個別の事前チェックは任意です。引数の処理とクリーンアップについては CLI のセットアップに従ってください。

追跡と納品

• 元の入力、実際の session_id／room_url、すべての Task ID を保持してください。別の監視プロセスを並行して開始せず、元のコマンドの stdout と stderr を別々に読み取ってください。
• TASK_STATE_COMPLETED になり、このタスクから実際に使用可能な出力 URL が得られてから納品してください。HTTP 200、ストリームの終了、終了コード 0、または end.reason=result だけでは完了の証明になりません。不明な状態を成功として扱わないでください。
• 使用可能な場合はネイティブのプレビューまたは添付ファイルを使用し、そうでない場合はクエリパラメーターを含む完全なクリック可能な URL を提示してください。使用可能な Part と、成功した部分的な結果をすべて納品してください。実際に返されたセッション URL を含め、ID から URL を組み立てないでください。
• 接続の切断、タイムアウト、または受理状況が不確かな場合は、まず元のセッションとタスクを照会してください。確認済みの失敗を修正し、許可を得てから処理を再試行してください。出力のダウンロードに失敗した場合は、処理を再実行せずにダウンロードを復旧してください。詳細は「ランタイムと復旧」を参照してください。