動画用モーショングラフィックス
指示は日本語で記述されています。ユーザーの言語で応答してください。
なぜ必要なのか
テロップやグラフィックを1つずつ「目視」で作成すると、3つ目にはバラバラになります。あるテロップは下から0.5秒で入り、別のものは横から1秒、フォントは2ポイント大きく、アクセントカラーも異なります。視聴者は言葉にしませんが、動画は他人の作品を寄せ集めたように見えます。
このモーションスタジオはHyperFramesをベースに構築されており、スタジオはそれを自社のファクトリーに拡張しています。ブランドに関する決定は1回だけ行われ、ファイルに記録されます。動画はシーンロールのブリーフで記述され、エージェントがブリーフをコンポジションに変換してレンダリングします。新しいテロップは、たとえ別のエージェントが1ヶ月後に作成しても、他のものと統一されます。
動作環境
| ツール | 役割 | 入出力 |
|---|---|---|
| HyperFrames | エンジン:シーンはHTMLコンポジション、動画にレンダリング、独自チェック機能 | HTML, CSS, GSAPタイムライン → MP4, WebM, またはアルファ付きMOV ProRes 4444 |
| Claude Code(または類似品) | エージェントがブリーフからシーンを組み立てる | ブリーフ + ブランドファイル → コンポジション、レンダリング、チェック |
| ブランドファイル | 色、フォント、モーション、余白を一元管理 | brand.json → 各シーンの数値 |
| ffmpeg | フッテージ上のドラフト、フレームリスト、黒フレーム検出 | アルファ付きシーン + 動画フレーム → プレビューとフレームリスト |
| ProRes 4444 | 編集用の透明背景の最終出力 | アルファチャンネル付きMOV |
| DaVinci Resolve(または類似:Premiere、Final Cut) | 編集、グラフィックを動画の上に配置 | フッテージの上のトラックにMOV ProRes |
エージェントは計画、ブリーフ、コンポジションを作成し、チェックを実行します。所有者は計画とドラフトを承認します。テキスト(名前、数字)は所有者またはクライアントが提供します。
HyperFrames はHeyGenのオープンソースエンジンです:https://hyperframes.heygen.com。
コンポジションは、時間用の data-* 属性、アニメーション用のGSAPタイムライン、スタイル用のCSSを持つHTMLファイルです。Node.js 22以降とffmpegが必要です。
| HyperFramesが提供するもの | スタジオが追加したもの |
|---|---|
| トラックとシーンタイミングを持つHTMLコンポジション | ブランドファイル:色、フォント、モーション、余白;レンダリング前にブランドルールを出力 |
hyperframes init、ブラウザスタジオでのpreview | 各コンポジションを手動で作成する代わりに、シーンロールによる動画ブリーフ |
hyperframes render:MP4、WebM、透明背景付きMOV ProRes 4444(--format mov)、--quality draft | ロールとテンプレートのライブラリ:ロールは特定ブランドのテンプレートに変換され、1つのブリーフで任意のブランドスタイルを適用可能 |
hyperframes lint、check、validate:マークアップとタイムラインのエラー、ブラウザエラー、欠落ファイル、テキストのコントラスト | 黒背景ではなく実際のフッテージ上のドラフトとコンタクトシート |
hyperframes add:レジストリからの既製ブロックとエフェクト | ドラフトと最終出力の黒フレーム比較、黒フレーム検出 |
hyperframes doctor:環境チェック | check_brand.py:最初のシーンの前にブランドファイルをチェック |
--docker:異なるマシンでも同一結果 | コンポジションに埋め込まれたローカルフォントとローカルGSAP、シーン別のファイル名 |
以下の原則は、コードを動画に変換する他のエンジンにも適用できます。
いつ使用するか
動画内のグラフィック(スピーカー名、チャプター、数字、エンドカード)、Shorts/Reelsのフック、編集用の透明オーバーレイ、グラフィック用の新しいブランド。
独自のストーリーを持つ10〜25秒のフルスクリーンプロモーション動画には使用しないでください。音楽のテンポに合わせたストーリーボード、動画ごとに1つの独自コンポジションが必要であり、シーンロールは邪魔になります。動画のストーリーボードは shot-list、記事の表紙は article-cover、生成フレームのスタイルは film-look が担当します。
3つのファイルで1つの大きなファイルの代わりに
- ブランドファイル
brand.json:色、フォント、テキストサイズ、モーションディクショナリ、ロールの持続時間、余白、セーフゾーン。ブランドごとに1つ、変更は稀です。架空のブランドと各フィールドのコメント付きサンプル:templates/brand.example.json。 - 動画ブリーフ
scenes.json:ロール別のシーンリスト。意味とテキストのみ、色もモーションの数値もありません。サンプル:templates/scenes.example.json。 - ロールテンプレート:各ロールに1つのHyperFramesコンポジションで、ブランドとシーンを読み込んで数値を代入します。独自テンプレートは自分で作成しますが、ロールごとに少量の作業です。良い出発点:
hyperframes initとhyperframes addによるレジストリの既製ブロック。
最も重要なルール:1つのシーンにのみ必要な色、フォント、または速度がブランドに記録されていない場合、それは警告です。ブランドに追加するか、破棄するかのどちらかです。「ここだけ」の調整こそがシステムを崩す原因です。新しいタイプが必要な場合:共通テンプレートを1つのプロジェクト用に変更するのではなく、新しいテンプレートを作成します。
ブランドファイルの設定方法
templates/brand.example.jsonをプロジェクトにbrand.jsonとしてコピーします。- ブランドのウェブサイトやガイドラインから色を取得します。ガイドラインがない場合:所有者に背景、メインテキスト、アクセントを尋ねます。クライアントの代わりにブランドカラーを考案しないでください。
- 各色に1つの値を割り当てます:背景、テキスト、2行目、アクセント。色の目的を説明できない場合、その色は不要です。アクティブカラーは最大5つまで。
- フォント:見出しと数字用に1つ、キャプション用に1つ、または1つで全てをカバー。サンセリフまたはセリフのみ。等幅フォントやピクセルフォントは、数字、日付、ラベルを含めどこでも使用しません。数字は幅が均等なサンセリフで設定:CSSで
font-variant-numeric: tabular-numsを使用。カウンターが跳ねなくなります。 - フォントはコンポジションに埋め込みます(プロジェクトのファイルとして、またはCSSに直接)。インターネット上のフォントはレンダリング時に読み込めない可能性があり、フレームがシステムフォントで出力されます。GSAPも同様にローカルに保持し、ネットワーク読み込みはレンダリング中に失敗する可能性があります。
rulesにブランドの制限を言葉で記録します:アクセントの使用方法、新しい色の導入の可否、事実の出典。エージェントは各ビルド前にこれらを読み取ります。そうしないと、セッション間で失われます。- チェックを実行します:
python3 scripts/check_brand.py brand.json
スクリプトは必須フィールド、16進数以外の色、テキストと背景のコントラストが4.5:1未満、等幅フォントやピクセルフォント、1080フレームで28ピクセル未満のテキスト、妥当な範囲外の持続時間、プラットフォームのインターフェースをカバーしないセーフゾーンをチェックします。違反がある場合、終了コード1を返します。
シーンロール
テンプレートではなくロールを記述します。ロールはシーンの目的を示し、テンプレートはブランドが選択します。ブランドを変更すると、ブリーフを書き換えることなく、同じロールが別のスタイルで構築されます。
| ロール | 目的 | フィールド | 背景 | 持続時間 |
|---|---|---|---|---|
hook | Shortsの最初の1〜3秒、視聴者を引き留める | title(3〜6語)、subtitle(任意) | 独自、フルフレーム | 2〜3秒 |
name | フレーム内の発言者 | title(名前)、subtitle(肩書き) | 透明 | 3〜5秒 |
chapter | 意味ブロックの切り替え | label(番号)、title | 独自または透明 | 2.5〜4秒 |
number | 覚えておくべき1つの数字 | value、unit、note | 透明 | 3〜4秒 |
endcard | 最後:名前、サイト、次のアクション | title、meta、ロゴ | 独自、フルフレーム | 4〜6秒 |
短い事実、コーナーノート、区切り文字付きリストもロールになることがあります(fact、note、list)。同じタスクが2回目に発生したときに新しいロールを作成します。1つのシーンだけのためではありません。
フレーム内の位置 at:bl、br、tl、tr、left、right、center。
名前テロップはほとんどの場合、スピーカーの視線と反対側の左下に配置します。
テキストはブリーフからのみ取得します。名前、肩書き、数字、アドレスは創作しません。データがない場合は尋ねます。テロップの姓の間違いはすべての視聴者に見えます。
言葉でモーションを指定
シーン内のモーションは、プログラマーではなく監督のように記述します:
アクセントラインが左から描かれ、その後に名前が上がり、役職が続いて現れます;保持;全てが1つの動きで下に消えます
エージェントはこれをブランドの数値とGSAPトゥイーンに変換します:「上がる」は motion.travel_px の移動、motion.enter_sec の時間、減速 ease_enter、「続いて」は stagger_sec の待機時間、「消える」は exit_sec です。説明に必要な単語がない場合は、ブランドのデフォルトを使用し、速度を考案しないでください。
- 1シーンに1つのアイデア。 シーンが2つのことを伝える場合、それは2つのシーンです。
- まず最終フレーム、次にモーション。 すべてが配置された瞬間のシーンをデザインし、その後で入場と退場を追加します。これにより、レンダリング前にオーバーラップを確認できます。
- 入場は退場より遅く。 出現は減速、退場は加速で約2倍速く。視聴者は入場を追い、退場は必要ありません。
- 動画全体で1つの方向。 下から入り、同じ軸で下または上に消えます。方向の混乱は編集ミスとして認識されます。
- シーン内で2つ以上のテクニックを使用しない。 移動とフェードで十分です。回転、バウンス、ぼかしを同時に使用すると、エンジンのデモリールのようになります。
- 短い距離、要素は順番に。 30〜60ピクセルの移動は高級に見え、画面半分の移動は安っぽく見えます。ライン、次に名前、次にキャプション。
- フックは単語ごとに、文字ごとではありません。 文字ごとは遅く、読みにくくなります。
- 最後は静止 して3〜4秒保持します。そうしないと読む時間がありません。
- コードにランダム性を含めない。 乱数や現在時刻は、レンダリングごとに異なる画像を生成します。ばらつきは要素番号から計算式で取得します。
タイミングとスマートフォンでの可読性
- テキストは完全に表示された後、少なくとも
min_hold_sec秒間静止して保持されます。 - 読む時間:1単語あたり約0.3秒+入場時間。6単語のテロップは3秒未満では不十分です。
- 適度なテキストサイズ。画面全体の巨大な見出しは叫んでいるように見えます。
- 短辺1080ピクセル:見出し64〜110、キャプションは40以上、ラベルは28以上。スマートフォンではこれより小さいと読めません。
- 1行は25〜30文字以内。長い場合は意味で分割し、幅で分割しないでください。
- フッテージ上のテキストには常に背景、影、または暗転を使用。コントラスト4.5:1は空の背景ではなく、その背景に対して計算します。
- アクセントは1つの単語または1つのラインに。アクセントで塗りつぶされた段落は読めません。
- シーンのタイムラインはそのスロット全体を埋める必要があります。最後にシーン全体の長さの空のトゥイーンを追加します。そうしないとHyperFramesがシーンを早期に非表示にし、動画に黒フレームが表示されます。
セーフゾーン
プラットフォームは画面の一部をインターフェースで覆います。短辺1080のフレームの数値。最新のプラットフォームのスクリーンショットで再確認してください。
9:16(1080x1920、Shorts、Reels、TikTok): 上部約250ピクセル(ニックネーム、ボタン)、下部約400ピクセル(キャプション、音楽、進行状況)、右側約140ピクセル(いいね、コメント)、左側約60ピクセル。フックと重要なテキストは中央の帯に配置。縦向きの名前テロップは通常より高く配置します。
16:9(1920x1080、YouTube、横長編集): 両側約96ピクセル、上部54ピクセル、下部約96ピクセル。最後の5〜20秒でYouTubeはエンドカードを配置するため、エンドカードはそのスペースを考慮して作成します。
ゾーンはブランドファイルに保存され、シーンはドラフトフレームにフレームを重ねてチェックします。
レンダリング
- ドラフト:
hyperframes render --quality draft、最終よりもはるかに高速。すべてのチェックに使用し、最終レンダリングは1回のみ。 - 通常の動画(MP4、H.264): フック、最終カード、およびフルフレームで表示されるすべてのもの。アルファはファイルを重くするだけです。
- 編集用の透明背景: フッテージ上のテロップ、チャプター、数字。HyperFramesはDaVinci Resolve、Premiere、Final Cut用にアルファ付きMOV ProRes 4444(
--format mov)をレンダリングし、ウェブ用にはアルファ付きWebM(--format webm)を提供します。MP4はアルファを保存しません。編集用のフルフレームグラフィックスはffmpegでProRes 422 HQに変換でき、軽量です。 - グラデーションのバンディング対策:軽いノイズ(
texture.grain)とProResマスター。 - PNGでのフレームキャプチャを有効にしない(
--video-frame-format png):スタジオのチェックでは、暗い部分が黒くつぶれる可能性があります。 - ファイル名はシーンごとにラテン文字で:
name-01-sokolova.mov。
最終レンダリング前のフッテージ上のドラフト
黒い背景ではすべてが正常に見えます。問題は実際の画像でのみ明らかになります:テロップが顔を覆う、白いテキストが窓に消えるなど。
- 透明背景でドラフト品質のシーンをレンダリング。
- ffmpegがそれらを実際の動画のフレームまたはクリップに重ね(ブリーフの
preview_bg:ファイル、動画、またはフレームフォルダ、シーンに順番に割り当てられます)、1つのプレビューに結合。 - コンタクトシート:各シーンの開始、中間、終了を1つの画像に。
- 目視確認と、番号付きシーンリストを所有者に見せて、一言で回答を得る。lintを通過してもデザインが機能するとは限りません。
チェック
- 新しいテンプレートごと、表示前に
hyperframes lint。hyperframes check(lint、ブラウザエラー、配置、テキストコントラストを1回で実行)、hyperframes doctor(レンダリングがクラッシュする場合)。Lintは実際のバグをキャッチします:開始時に透明度がゼロの全画面レイヤーは最初のフレームを露出オーバーにします;translate(-50%,-50%)による中央揃えがyのトゥイーンと組み合わさると最後にずれるため、flexラッパーで中央揃えにします。 - ドラフトと最終出力の黒フレーム検出:ffmpegがフレームの明るさを抽出、完全に黒いフレームは欠落したシーンまたはフリーズした動画を示します。コンポジション内の各動画には固有の
idが必要です。そうしないとフレームがフリーズします。 - ドラフトと最終出力の黒フレーム比較:黒くつぶれたピクセルの割合が増加しないことを確認。
作業手順
- ブランド:
brand.jsonはありますか?ない場合は作成し、スクリプトでチェック。 - 計画:ロール、テキスト、フォーマット、持続時間を含む番号付きシーンリスト。動画ではなく計画を表示:
ブランド:Fjord Lab、16:9、テロップはアルファ
01. name / bl / アルファ:「マリア・ソコロワ」・「音響エンジニア」、4秒
02. chapter / アルファ:「第2章」・「私たちが静寂を書く方法」、3秒
03. number / right / アルファ:48時間・「1つのエピソードの録音」、3.5秒
04. endcard / MP4:「Fjord Lab」・fjordlab.example、5秒
- 承認された計画に基づいて
scenes.jsonブリーフを作成。 - ロールごとにコンポジションを作成、
hyperframes lintを実行。 - フッテージ上のドラフト、コンタクトシート、黒フレーム検出、表示。
- 修正は言葉で(「3番目を短く」「名前を大きく」)ブリーフに反映、共通のもの(「すべてのテロップを遅く」)はブランドに反映。
- 最終レンダリング、透明シーンはProRes 4444、ドラフトとの比較、編集用フォルダにファイルを出力。
よくある間違い
- シーン内に直接色や速度を記述。 5つの動画後、プロジェクトに5つの異なるアクセントが存在します。視覚的なものはすべてブランドのみに。
- フラットな背景でのグラフィック評価。 テロップは「完璧に見える」が…
...