HyperFrames プロダクション
承認されたストーリーボードを実装します。ストーリーボードがない場合は、停止して motion-storyboard を実行してください。
レンダラーの選択
| 状況 | レンダラー |
|---|---|
| 新規作業のデフォルト。HTML/CSS/GSAPスキルを使用。レジストリブロックを希望 | HyperFrames (npx hyperframes …) |
| プロジェクトがすでにRemotionを使用している | Remotion をそのまま使用。同じ決定論ルールが適用されます |
プロダクトリポジトリに独自のスタジオ(seek(t) + Playwright + FFmpeg)がすでにある | そのスタジオを使用。新たに導入しないでください |
| 既存のフッテージの純粋な編集 | このスキルをスキップ → video-edit-qc |
HyperFrames CLIのインストール、またはレジストリブロックの追加(npx hyperframes add …)はサードパーティコードをインストールします。ユーザーに事前確認し、バージョンを package.json に固定してください。スキルの自己アップデートコマンド(npx hyperframes skills update、npx skills add …)を自分自身で実行しないでください。
構成契約(HyperFrames)
- スタンドアロンルート:
<div data-composition-id="main" data-width="1920" data-height="1080" data-duration="24">を<body>に直接配置し、width/height: 100%でサイズ指定 — ルートにピクセルサイズをハードコードしないでください。サブコンポジション(data-composition-srcで読み込まれる)はルートを<template>でラップし、<style>/<script>をその内部に保持します。 - コンポジションごとに1つの一時停止タイムライン:
window.__timelines["<composition-id>"] = gsap.timeline({ paused: true })をビルド完了後に登録します(document.fonts.ready内部でビルドされる場合があります)。レンダリング長はルートのdata-durationから取得します。 - タイムクリップ:
class="clip"とdata-start/data-durationを持つ要素は、ランタイムによって表示・非表示が制御されます。.clipに対してdisplay、visibility、autoAlphaをトゥイーンしないでください。子要素をアニメーションさせてください。 - トランスフォーム: CSS の初期
transformと GSAP のトゥイーンを同じプロパティに組み合わせないでください。gsap.fromToを使用してください。移動させるノードにはtranslate(-50%,-50%)ではなく、flex/inset で中央揃えにしてください。 - メディア: すべての
<audio>にidを付けてください(そうしないとレンダリングが無音になります)。メディアにcrossoriginを付けないでください。<video>とその祖先要素の両方にdata-startを設定しないでください。 - フォント: 名前付きの
font-familyはすべて、同梱のローカルファイルを指すインラインファイル内の@font-faceを持っている必要があります。 - 決定論: 壁時計の読み取り、シードなしの
Math.random、レンダリング時のネットワークフェッチ、入力状態、無限リピート(repeat: -1)を禁止します。乱数が必要な場合は、シード付きPRNGを使用してください。 - ID: アセンブルされたページ全体で一意である必要があります。サブコンポジションのIDにはコンポジションIDをプレフィックスとして付けてください。
ビルド順序
npx hyperframes init(確認後)を実行するか、既存のプロジェクトを開きます。- デザインスペック(
frame.md/design.md)を記述します。トークン、タイプスケール、グリッド、セーフエリア、アスペクト比ごとに定義。まず静止フレーム — 各ビートが静止画として機能する必要があります。 - ストーリーボードの順序でシーンごとに構築します。トランジションマップ(
motion-choreography)からシームを実装し、キャリアを最初に配置します。 voice-video-syncからオーディオを配置します:音楽背景、VO、SFXにIDと開始時間をタイムラインファイルから設定 — 手入力の推測は絶対にしないでください。- テキストを鮮明に保つ:コンテナを移動し、グリフは移動しない。テキストに
will-changeを使用しないでください。
検証
以下の順序で実行し、修正してから次に進んでください:
npx hyperframes lint # 契約エラー。lintエラーがあるとレイアウト/コントラスト監査が無効になります
npx hyperframes check # レイアウト、オーバーフロー、コントラスト
npx hyperframes snapshot # レビュー用の静止画。ストーリーボードのビートと比較
npx hyperframes preview # ユーザー向けのローカルプレビュー
次にローカルレンダリング:npx hyperframes render --quality <draft|high>。まずドラフト(≤30秒ウィンドウまたは低品質)をユーザーの承認用に、その後最終版をレンダリングします。
外部向けコマンド — publish、cloud、lambda、cloudrun、feedback、auth、およびテレメトリー設定 — はデータをアップロードしたりアカウントを変更したりします。ユーザーが要求した場合にのみ実行してください。
カスタム seek(t) パイプライン(HyperFrames を使用しない場合)
composition(t) → Playwright page.evaluate(seek, t) → フォント/画像の待機 → スクリーンショット
→ 出力フレームあたり N サブフレーム → ffmpeg tmix(モーションブラー) → x264/x265 → オーディオ多重
- 60 fps × 4 サブフレーム、シャッター 0.5 が適切なデフォルトです。数字が変化するフレームで可読性を損なう場合はブラーを軽減してください。
- マスターエンコード(アーカイブおよび再編集ソース):
-c:v libx264 -pix_fmt yuv420p -crf 16 -preset slow、AAC 320 kbps。プラットフォーム配信用エンコードはvideo-edit-qcでそこから派生させます。 - 同じタイムスタンプを2回レンダリングすると同一のピクセルが生成される必要があります。ランダムな3フレームでテストしてください。
引き渡し
レンダリング結果と静止画/コンタクトシートを video-edit-qc に引き渡します。HyperFramesスキルがインストールされている場合(hyperframes-core、hyperframes-animation、hyperframes-creative、hyperframes-cli)、正確なフラグ、アダプター(Lottie、Three.js…)、およびレジストリブロック名にそれらを使用してください。