UIデモコンポーザー
ここでの製品ビデオは、ビデオごとに作成する3つのファイルと、すべてのビデオで共有されるキットから構成される1つのHyperFramesコンポジションです。
| ファイル | 説明 | 編集者 |
|---|---|---|
video/build.py | ビートテーブル T:すべてのタイミングは単語のタイミングから導出される | あなた |
video/src/template.tpl | 再構築されたUI、スクリーンレイヤー、GSAPタイムライン | あなた |
video/src/app.css | 製品UIのCSS、specs/からのリテラル値 | あなた |
kit/stage.css, kit/titles.css, kit/stage.js | ステージレイヤーとシークセーフなヘルパー | このスキル |
products/<slug>/kit/tokens.css, fonts/, icons/, ui/ | 製品のトークン、フォント、アイコン、共有UIパーツ | product-kit |
video/index.html | build.pyによって生成される。手動で編集しない | 誰もしない |
scripts/buildlib.py はすべてのビルドに共通の部分(タイミング、署名ゲート、オーディオタグ、インライン化、プレースホルダー、アイコン、カメラクランプ)を処理するため、build.pyはビートの短いリストに留まります。
ステージモデル
#root > #stage > #camera > #blurWrap > #app 製品、アプリピクセル単位
> #veil, .pvs-ttl, #endS, #lock, #fade スクリーンスペース、1920x1080
- UIは実際のビューポートで再構築され、一度だけスケーリングされます。
#appはproduct.yaml app_canvas.logicalCSSピクセル(例:1440x810)で、1つのtransformによって1920x1080にスケーリングされます。 プロダクションCSSはリテラルなピクセル値を保持するため、スペックの値は変更せずに貼り付けられ、すべての測定値はコードと1:1で比較できます。 アプリのブレークポイントより上のデスクトップ幅を16:9で選択します。画面録画がある場合は、その論理サイズを使用します。 16:9でないキャンバスはレターボックス表示されます(buildlibが警告します)。 - 位置は測定され、入力されることはありません。
S.box(sel)はフォント読み込み後に#appまでのオフセットを合計します。CSSが変更されても、カーソルはボタン上に留まります。 - カーソルとクリックリップルは
#appの最後の子要素であるため、製品と一緒にスケーリングおよびブラーされます。ポップアップ(.pvs-modal)とトースト(.pvs-toast-slot)も#app内に配置されます。 #cameraのみが移動し、#blurWrapのみがブラーを適用します。#appや#stageをトゥイーンしないでください。
フレーミング:デフォルトは1倍の全ページ
すべての製品ビートはデフォルトで1倍、全ページとし、ポップアップは自然なサイズで、アプリが表示するように中央揃えにします。プッシュインは控えめに(最大 video.max_zoom、デフォルトは1.35まで)、セクション全体をフレーム内に収め、ラベルの端がフレームの端に掛からないようにします。チャプターごとに1つのフレーミング:製品がフォーカスアウトしている間にチャプタータイトルの後ろで移動を行うか、1つのゆっくりとした特徴的な動きとして行います。
理由:このスキルの元となったプロダクションでは、設定動画がズームのために2回却下されました。1.67倍の押し込みはラベルを半分に切りました(「何が起こっているかわからない」)。その後、列ごとに約2倍のフレーミングは、何も切っていなくても窮屈に感じられました。レビュアーが見本として挙げた動画は、常に1倍で動作していました。遠くに表示されたキャンバス(50%で表示)や狭いチャット列はより多くのズームに耐えられます。product.yamlでその製品の max_zoom を上げてください。ビートごとではありません。b.cam() と S.cam() は max_zoom を超えるとクランプし、警告を出します。詳細と数値:references/framing-and-pacing.md。
ペーシング:チャプターは間(ポーズ)
- UIの途中ではなく、コンテキストから始めます:ロゴ、製品名、製品が何であるかを1行で、製品をフォーカスアウトした状態で表示します。
- 各チャプターは、製品をラックフォーカスアウト(ブラーとベール)した状態で2トーンのタイトルから始まり、約1.4秒以上保持し、フォーカスは最初のアクションを指定する単語の直前に戻ります。画面の変更はタイトルの背後で行われるため、ハードカットはありません。
- チャプターごとに1つのアイデア、一度に1つの変更、0.6〜1秒間隔、各チャプターの最後に約0.8秒のホールド。製品の実際の待機時間は1〜2秒に圧縮します。
- エンドスクリーンは幅広さ(製品が他に何ができるか、実際のUIパーツを使用)を示し、その後ロックアップを表示します。
理由:0.5秒ごとにマイクロアクションがある密度の高いワンテイクカットは、作成者には洗練されていると読まれ、レビュアーにはノイズと読まれました(「速すぎる、一度に多すぎる、圧倒される」)。結果のズームイン・アウトはフォローするのを不可能にしました。落ち着いたチャプター分割バージョンが承認されました。
すべてのビートは単語にアンカーされる
b = buildlib.Build(__file__)
T, w, end = b.T, b.w, b.end
T["N2"] = T["ch1"] + 0.3 # クリップIDを配置するとそのクリップが配置される
T["rack1"] = T["N2"] + w("N2", "after") - 0.25 # "after"の直前にフォーカスが戻る
T["send1"] = max(T["type1"] + T["type1Dur"] + 0.4, end("N3") + 0.15)
w(clip, prefix, nth=1)は、クリップを基準として、prefixで始まる最初の単語の開始位置です。単語が見つからない場合はエラーを発生させます(黙ったフォールバックなし:フォールバックが静かにデフォルトのタイミングにビートを配置すると、モーションが気付かれないうちに音声からずれていきます)。- UIイベントは、それを指定する単語より0.05〜0.45秒先行します。
max()はナレーションの順序と「UIが完了した」ことの両方を保証します。end(k)はT[k]にクリップの継続時間を加えたものです(またはb.dur(k, d))。 - タイピング速度は1秒あたりの文字数(約17〜21)、またはビートに合わせて固定されます。
- クリック、タイピング、ポップはそれぞれ同じ
Tでサウンドを取得します(b.click(t)、b.typing(text, t, dur)、b.pop(t))。そのため、タイミングを変更したビートはそのサウンドも一緒に移動します。 - 音声の1行を再生成すると、ビデオ全体のタイミングが再計算されます。それがポイントです。
理由:タイミングには単一の真実のソースがあります。行が再生成されると、それにアンカーされたすべてが一緒に移動します。手動で入力した秒数は、最初のリテイクで古くなります。
ワークフロー
BRIEF.md(チャプター、フレーミング)、COVERAGE.md(各チャプターが画面上で説明しなければならないこと)、specs/*.md、TRUTH.mdを読みます。UIを発明しないでください:SOURCES.mdまたはspecs/にソースがない画面や動作は含めません。- スペックから
src/template.tplとsrc/app.cssで画面を再構築し、product.yamlcastからの架空のデータを使用します。別のビデオからコピーする代わりに、kit/ui/から{{UI:name}}を使用して製品パーツを再利用します(references/ui-component-library.md)。 build.pyにビートを記述し、テンプレート内のタイムラインをキットヘルパーを使用して記述します(APIについてはreferences/stage-kit.md、各ビートについてはreferences/beat-recipes.md、エンドスクリーンとロックアップについてはreferences/end-screen-and-lockup.md)。すべてのトゥイーンに対してシークセーフモーションのスキルに従います。- ドラフトをビルドし、出力されるビートテーブルを読みます:
音声が存在する前でも、PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)" "$PVS_HOME/bin/pvs-py" <video_dir>/video/build.py --draft--draft --fake-timingsはlines.tsvから単語のタイミングを生成するため、画面をレイアウトできます。 - lintとチェックを実行します。
<video_dir>/video/から:エラー0、ランタイム警告0を期待します。モノリシックなステージに対しては1つのlint警告が予想されます:"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/seek-safe-motion/scripts/lint_motion.py" . npx --yes [email protected] checkcomposition_file_too_large(キットがインライン化されています)。次に、ビルドが出力する2番目のcheckを実行します。check --at <setup beat times>:デフォルトのサンプルはラックされた瞬間にのみ配置されることが多く、キットはコントラストパスから製品テキストを隠します(意図的にブラーがかけられています)。そのため、contrast ... checked 0はビューアが読むものを何も監査しませんでした。checkだけでは不十分です。移動するアイテムがその経路の大部分で見えなかったビデオで合格しました。フレームを確認してください。 - すべてのセットアップビートのスナップショットを撮り、各画像を自分で確認します。build.py で
b.snap(t, label)を使用してマークします。ビルドは正確なコマンドを出力します:npx --yes [email protected] snapshot . --at 3.2,4.7,9.98 --no-end --describe false -o snapshots/setup--no-endはそれらの時刻のみをキャプチャします。--describe falseはフレームが外部のビジョンAPIに送信されるのを防ぎます。フレーミング(端で何も切れていないか)、ターゲット上のカーソル、自然なサイズで中央揃えされたポップアップ、タイトル全体を確認します。--zoom "#toast" --zoom-scale 2は1つの要素を切り抜きます。疑わしいトゥイーンをテストするには、--at <start>,<later>は--at <later>と一致する必要があります。 - レンダリングします。レビュー用のドラフト、その後 BRIEF.md が署名されたら納品用(build.py がこの行を出力します):
その後、MP4に対してrender-qaを実行します。すべてのバージョンのMP4を保持します。npx --yes [email protected] render . -o renders/<video>-v<k>.mp4 --fps 30 --quality draft npx --yes [email protected] render . -o renders/<video>-v<k>.mp4 --fps 30 --quality delivery
署名ゲート
build.py は、coverage_signed_by と claims_signed_by が BRIEF.md に設定されるまでビルドを拒否します(終了コード2)。--draft はとにかくビルドし、<meta name="pvs-draft" content="1"> を index.html にスタンプします。QAはレポートをドラフトとしてマークし、納品はそれを拒否します。レビュアーに代わって署名しないでください。また、メタを削除しないでください:ドラフトは確認用であり、出荷用ではありません。
理由:このスキルの元となったプロダクションでは、26バージョンのうち9つが、ビデオがレビュアーの気になる機能を説明しておらず、ビルド前にそれらの機能を誰も書き留めていなかったために発生しました。ゲートは合意が最初に来るようにします。
インシデントから来たルール
- プロダクションのグリッチを修正し、見た目は維持します。 レイアウト、トークン、動作は1:1に保ちますが、ライブアプリの目に見える欠陥(パディングの欠落、あふれている、または切れているテキスト、グレーのネイティブコントロール、クリック後に残ったフォーカスリング)を修正します。すべての修正を BRIEF.md のノートにリストします。
- 製品が設定可能な場合は、設定可能なものを表示します。 購入者が尋ねるであろう設定は、ナレーションだけでなく画面上に表示する必要があります。
- メニューを閉じてから、その上にモーダルを開くまで1フレーム空けます。 新しいダイアログの下にある開いたドロップダウンは、1つのレンダリングでゴーストテキストを残しました。
- エンドスクリーンのコンテンツのみをロックアップにフェードインし、 ロックアップが表示されるまでその背景を保持します。両方をフェードすると、それらの間にシャープなUIのフレームが表示されました(
S.lockupはこれを行います)。 - クリックの前にホバーします(
hovクラスを約0.12秒前に)、カーソルは最初のラック後にインし、エンドスクリーンの前にアウトします。 - UI、データ、ナレーションに ベンダー名や禁止用語 を含めません(product.yaml
banned_terms、names)。実際の画面に表示される場合は、その部分をフレームの外に保ち、決して視覚的に空のままにしないでください。 - 進行状況を早く示すためにレンダリングしないでください。 スナップショットで反復します。セットアップビートが正しく見えたらレンダリングします。
ファイル
| パス | いつ読むか |
|---|---|
references/stage-kit.md | ヘルパーのシグネチャ、プレースホルダー、CSS変数、またはbuildlib APIが必要なとき |
references/beat-recipes.md | 特定のビート(オープニング、チャプター、クリック、タイピング、ストリーミング、ポップアップ、ドロップダウン、トースト、スクロール、プッシュイン)を構築するとき |
references/framing-and-pacing.md | フレーミングやリズムを選択するとき、またはレビュアーが「ズーム」「速い」「混沌」と言ったとき |
references/end-screen-and-lockup.md | エンディングを構築するとき |
references/ui-component-library.md | UIパーツが複数のビデオに表示される場合、または別のビデオからマークアップをコピーしようとしているとき |
scripts/buildlib.py | APIリファレンスがカバーしていない動作が必要なとき |
kit/stage.js | 同上、タイムラインヘルパー用 |
PVS_HOME/_template/video/video/ | すべての新しいビデオの開始点となるサンプルのbuild.py、template.tpl、app.css |