vmake-video-repair

動画品質の修復

機能と準備

video-repair を使用して、鮮明さとディテールを向上させ、ぼやけや映像ノイズを低減します。入力と品質目標が明確になったら処理を進めます。音声トラックの処理は、適切な音声機能に振り分けてください。

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

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

入力の収集

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

アップロードと送信

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

vmake tool video-repair --video-file '<local-video-path>'

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

進捗の確認と納品

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