HyperFrames
このスキルは、ユーザーが Parsifal に対して HyperFrames を使用した動画作成を依頼した場合に使用します。例えば、30秒の縦型動画、短いイントロ、シネマティックなマイクロトレーラー、製品プロモーション、アニメーションキャプション、HUDスタイルのテクノロジービジュアル、Web サイトから動画への変換、または HTML/CSS/JS のモーショングラフィックスレンダリングなどが該当します。
HyperFrames は HTML を動画のソースオブトゥルースとして扱います。ビデオシーンを HTML コンポジションとして CSS レイアウトと JavaScript アニメーションで構築し、レイアウトを検証した上で、結果を MP4 にレンダリングします。
セットアップ
HyperFrames がインストールされていない、または公式スキルがない場合は、まずインストールします:
parsifal skills install official/creative/hyperframes
プロジェクト操作には npx hyperframes を使用します。HyperFrames には Node.js と FFmpeg が必要です。レンダリングまたはプレビューが失敗した場合は、以下を実行します:
npx hyperframes doctor
ワークフロー
- ユーザーのリクエストを短いプロダクションブリーフに変換します: 長さ、アスペクト比、ターゲットプラットフォーム、言語、スタイル、音楽やナレーションの必要性、最終的な出力パス。
- 不完全なブリーフの場合は、妥当なデフォルト値を設定します。縦型ショートビデオには 1080x1920、横型ビデオには 1920x1080、30 fps、MP4 出力を使用します。
- HyperFrames プロジェクトを作成するか、再利用します:
npx hyperframes init my-video --non-interactive
- コンポジションを HTML/CSS/JS で記述します。アニメーションを追加する前に、静的なヒーローフレームのレイアウトを正しくします。
- レンダリング前に検証します:
npx hyperframes lint
npx hyperframes inspect --samples 15
- 必要に応じてプレビューします:
npx hyperframes preview
- 最終的な動画をレンダリングします:
npx hyperframes render --output final.mp4 --quality standard
高速な反復には --quality draft を、ユーザーが洗練された出力を求める場合の最終納品には --quality high を使用します。
コンポジションルール
data-composition-id、data-width、data-heightを持つルート要素を使用します。- タイムドクリップには
data-start、data-duration、data-track-indexを使用します。 - GSAP タイムラインを同期的に
window.__timelinesに登録します。 - CSS を最終レイアウト状態として使用し、その状態からアニメーションを開始または終了します。
- メディアの再生は HyperFrames ランタイムに任せます。
play()、pause()、またはメディアのシークを手動で呼び出さないでください。 - シード付きジェネレーターを使用しない限り、
Math.random()やDate.now()などの非決定的なアニメーションロジックは避けてください。 - 無限リピートは使用しないでください。コンポジションの長さから有限のリピート回数を計算してください。
- 検査したすべてのタイムスタンプで、テキスト、キャプション、UI パネル、HUD 要素がフレーム内に収まっていることを確認してください。
納品
完了したら、ユーザーに以下を伝えます:
- レンダリングされた MP4 のパス;
- プレビューサーバーが実行中の場合はプレビュー URL;
- 長さ、アスペクト比、スタイル、ナレーション、音楽について行った前提;
- 未解決の検証問題。
HTML を書いただけでは終了しないでください。HyperFrames のタスクは、lint と inspect でコンポジションがチェックされ、MP4 にレンダリングされた後にのみ完了します。ただし、ユーザーが明示的にソースファイルのみを要求した場合は除きます。