製品デモの記録
ユーザーの製品とアクションの説明を、チェックイン可能な記録シナリオに変換し、実際のアプリケーションに対して実行し、生成されたアセットを要求されたプレビューに適用します。
ワークフローの選択
- 製品の初めてのデモの場合は、references/new-product-workflow.md と references/scenario-schema.md をお読みください。
- 既存のシナリオの場合は、references/scenario-schema.md をお読みいただき、要求された動作のみを更新し、ユーザーが別途指示しない限り、同じ適用パスに再記録してください。
ワークフロー
-
製品ルート、安定したインタラクションセレクタ、およびそのプレビューを消費するコンポーネントを見つけます。要求されたコンテンツ、順序、フレーミング、持続時間、出力場所を維持します。
-
scripts/demo-video-scenarios/<product-slug>.jsonを作成または更新します。初めてのデモの場合は、npm run init:demo -- --product "<name>" --route <route> --consumer <file>で初期化し、スターターアクションを要求されたシーケンスに置き換えます。製品固有の動作は、レコーダーにハードコーディングするのではなく、シナリオに保持します。 -
実際のブラウザアクションを使用します。視聴者がデバウンスされた更新、完了したアニメーション、または中間状態を確認する必要がある場合は、意図的な待機を追加します。総アクション時間は記録時間より短く保ちます。使用されなかった時間は最終的なホールドになります。連続アニメーションの場合は、その全実行時間と読み取り可能なホールドを予算化し、
quality.motionChecksウィンドウを追加します。 -
生成されたメディアは、既存の製品が別の公開アセット場所を使用していない限り、
public/previews/の下に配置します。application.consumerFilesと公開パスを設定して、ランナーがアセットが適用されたことを確認できるようにします。新しいプレビューを追加する場合は、最初にコンシューマーにパッチを適用します。すでに参照されている出力を上書きすることは、更新の適用と見なされます。 -
実行:
npm run record:demo -- --scenario scripts/demo-video-scenarios/<product-slug>.json -
コマンドの終了だけでなく、結果を検証します:
- レコーダーは
verify:demoを実行し、正確な期間、寸法、正方形ピクセル、平均フレームレート、フレーム数、H.264エンコーディング、および設定された連続モーションチェックに合格する必要があります。 view_imageを使用して、印刷されたすべての全体およびモーションのコンタクトシートを開きます。入力された値、中間の製品変更、均等に分散されたモーション、トランジションの両端、最終状態を確認します。npm run lintを実行します。プレビューを適用中に行われたアプリケーションUIの変更に対して、AGENTS.mdで要求されるチェックを実行します。
- レコーダーは
スムーズモーション契約
- アニメーションデモでは、本当の60fpsを優先します。ソースキャプチャの報告されたフレームレートの上限を尊重します。フレームの重複やWebGLモーションの補間によって、より滑らかな出力を宣伝しないでください。
- 主要なトランジションには、明確に読み取れる十分なシナリオ時間を割り当てます。製品の意図された期間を使用します。期間がなく、スムーズさが重要である場合は、方向ごとに約2〜3秒から始め、後のアクションを急がずに全体の動画を延長します。
- 連続的に動くべき各間隔を
quality.motionChecksでマークします。デフォルトのゲートは、連続する同一フレームの重複を許可しません。製品がその間隔内で意図的にホールドする場合にのみ緩和し、その理由をシナリオの説明に文書化します。 - 密集したモーションコンタクトシートから視覚的にペーシングを判断します。有効なフレーム数では、前倒しや急なイージングカーブを検出できません。
- 実際の製品アニメーションがそれ自体でカクカクしており、ユーザーがスムーズさの向上を求めた場合は、フレームペーシングまたはイージングを修正し、再記録する前に関連するUIチェックを実行します。それ以外の場合は、製品の動作を維持し、後処理で隠蔽するのではなく、制限を説明します。
キャプチャの不変条件
- 実際のViteアプリケーションを、Chromeのネイティブなタブコンポジターストリームを通じて記録します。Puppeteerはキーボード、ポインター、タイミングを提供する場合がありますが、製品は自身の状態更新とレンダリングを実行する必要があります。
- WebGLモーションの場合、ネイティブタブキャプチャをDevToolsのスクリーンショットサンプリングに置き換えないでください。中間フレームが省略され、偽りのトランジションになる可能性があります。
- 実際のキャプチャレートを超えてエンコードしたり、モーション補間を使用してスムーズさのリクエストをパスしたりしないでください。
- ユーザーのフルデスクトップや既存のディスプレイをキャプチャしないでください。ローカル拡張機能は、選択されたローカルホスト製品タブのみをキャプチャできます。
recordingCssはデモのフレーミングにのみ使用します。ユーザーがそのUI変更も要求しない限り、記録を簡単にするためだけに実際の製品UIを変更しないでください。- シナリオに任意のJavaScript評価アクションを追加しないでください。インタラクションが本当にサポートされていない場合、ランナーに狭く名前付けされた実際の入力アクションを追加します。
- ネイティブタブキャプチャが実行できない場合は、シミュレートされた動画を静かに生成する代わりに、具体的な前提条件を報告します。
リクエストの解釈
リポジトリからルート、セレクタ、既存のアセットコンシューマーを推測します。調査後に複数の製品または実質的に異なる出力配置が妥当である場合にのみ質問します。
ユーザーが技術的な詳細なしに「<製品>のデモを作成/初期化して適用」と言った場合は、実装されたルート、カタログコンシューマー、セレクタ、既存のプレビュー規則を推測します。デフォルトは8秒、60fps、ポートレートフレーミングとしますが、リポジトリとリクエストがより良い規則を提供しない場合に限ります。デモのリクエストは、存在しない製品を実装することを許可しません。
適切なリクエストは、次のように簡単なものになります:
Design QRに
$record-product-demoを使用: URLを2つの部分に入力し、ツリーの更新のために一時停止し、3Dから2Dへ、そして元に戻すように変換し、カタログカードに適用します。
ユーザー向けの初期化とプロンプトの例は、デモ動画ワークフロー に文書化されています。