ゲームの動画制作
Playgama用のゲーム動画はこのように作ります。動画はPlaygamaではなく、ゲームそのもののように見えます。ゲームの色、フォント、パネル、サウンドを使用します。Playgamaはロゴ(先頭3秒のスティングとコーナーの小さなバグ)とリンクを追加します。残りの作業は3つの場所にあります。ストーリーは真実で具体的、ゲームプレイはきれいに撮影され、最初の1秒で次の1秒を見る価値を生み出します。
バンドルファイル:
| ファイル | 説明 |
|---|---|
assets/playgama-ai-logo.svg, .png | 公式Playgama AIロゴ(591×133):紫色のピル型にplaygamaワードマーク、その隣にグレーのボックスに「AI」が切り抜かれています。PNGは4倍サイズ、透明 |
assets/template/ | HyperFramesのスタータービデオ、1920x1080:スティング、3つのゲームプレイスロット、タイトル、エンドカード、音楽、音声トラック。上部のテーマブロック1つでゲームのルックを保持 |
assets/sting-preview.mp4 | イントロアニメーションの表示例。ゲームのビデオが始まるプレースホルダーに引き継ぎます |
assets/sting.html | イントロアニメーション単体、プレーンCSS(7 KB、ライブラリ不要):任意のページやビデオツールにドロップ可能 |
assets/playgama-ai-sting.html | 同じアニメーションをレビューページとして、再生、速度、スクラブコントロール付き。タイムラインと色が明示されています。ブラウザで開いてゲームのスクリーンショットをドロップすると、ゲーム上にロゴが表示されます。デザイナーに渡すことも可能 |
scripts/film.mjs, scripts/vclock.js | 任意のWebゲームをフレームごとに撮影し、スムーズなMP4に任意のサイズで出力 |
scripts/doctor.mjs, scripts/new-video.mjs | マシンをチェックしてインストールすべきものを表示。ビデオのフォルダ(テンプレート、gsap、puppeteer)を作成 |
scripts/palette.mjs | ゲームが使用する色をスクリーンショットからサンプリング。コードにテーマがない場合に使用 |
scripts/voice.mjs | ナレーション:ElevenLabs、OpenAI、Gemini、Cartesia(または無料のドラフト音声)から取得。耳で選ぶためのページと、音楽を下げた音声トラック |
references/story-and-script.md | フォーマット、実際のセリフ例を含むビートシート、オンスクリーン素材のルール |
references/game-look.md | ゲームのルックを取得する方法:色、タイポグラフィ、パネル、モーション、サウンド、テンプレートのテーマ |
references/filming.md | テイクの撮影方法:準備、セットアップ、フレームごとのスクリプト、瞬間の選択、最初のフレーム |
references/voice-and-music.md | ナレーション(テキスト読み上げまたは自分の声)、「Playgama」の発音、テイクの確認、音楽レベル |
references/edit-and-render.md | HyperFramesでの編集:テンプレート、カード、縦型カット、チェック、レンダリング、レビュー |
必要なもの
macOS、Linux、Windowsで同じように動作します。
node scripts/doctor.mjsでマシンをチェックし、インストールすべきものを表示します。node scripts/new-video.mjs <folder>でビデオのフォルダ(テンプレート、gsap.min.js、puppeteer)を作成します。以降のコマンドはすべてそのフォルダから実行します。
- 撮影用: Node 22以上(HyperFramesが必要)、PATHにffmpegとffprobe、puppeteer。
film.mjsは実行元のフォルダ、またはスクリプトの隣でそれらを見つけます。ゲームはURLから実行可能である必要があります(開発サーバー、またはビルド上の静的サーバー)。 - 編集・レンダリング用: HyperFrames(
npx [email protected];初回実行で約370 MBのパッケージとヘッドレスブラウザをダウンロード)。 - ナレーション(自分の声でない場合): ElevenLabsのキー、または
scripts/voice.mjsが対応する別のサービスのキー(references/voice-and-music.mdに1度設定)、およびWhisperなどの音声認識でテイクを確認するため。 - 音楽用: 使用許可のあるインストゥルメンタルトラック。
ワークフロー
この順序で作業します。各ステップが次のステップに情報を渡し、2つの承認ポイントで時間を節約します。
- 動画の内容を合意する。 フォーマット、長さ、目標を最初に決めます(以下の表)。動画の目的(プレイヤー向け、ストアページ向け、他の開発者向け、Playgamaのチャレンジやカタログ向け)を尋ねます。
- 真実のストーリーを収集する。 実際のプロンプト、タイムスタンプ、コミット、バグ、数値、スクリーンショットを集めます(
references/story-and-script.md)。ゲームがAIエージェントで構築された場合、チャット履歴が最も豊富な情報源です。それを読み、時間と正確な引用を記録します。 - ゲームのルックを取得する(
references/game-look.md):ゲーム自身のファイルから、色、フォント、パネル、ロゴ、音楽、UIサウンドを取得します。テンプレートのテーマブロックに書き込みます。 - スクリプトを書き、承認を待つ。 ナレーションのセリフと画面に表示する内容を、1行ずつ書きます。開発者が文言とルックを承認してから、ナレーションを作成します。録音済みのナレーションを言い換えると、再度録音する必要があります。
- ゲームプレイを撮影し、スクリーンショットを取る
scripts/film.mjsを使用し、配信サイズで行います(以下の「ゲームの画像」とreferences/filming.mdを参照)。スクリプトのビートごとに1テイク、それぞれ数秒間、ゲーム自身のコントロールやデバッグフックを使ってステージングします。 - 静止画を作成する ゲームのルックで行います。実際のコードと実際の行番号、実際のプロンプトとエージェントのステップ、Webページ、カバーを使用します。
- ナレーションを録音し、音楽を選ぶ(
references/voice-and-music.md、scripts/voice.mjs)。人間がナレーションのテイクを聞きます。テキスト読み上げは、どの書き起こしも捉えられない方法で失敗するからです。 - テンプレートを使って編集・レンダリングする(
references/edit-and-render.md)。チェックを実行し、レンダリングし、数秒ごとにフレームを抽出して、すべてを確認してから完了とします。 - パッケージ化する: サムネイル(1280x720、ゲームのベストフレーム、ゲームのフォントで最大4つの大きな単語)、タイトル、ゲームのリンク付きの説明文。
最初にフォーマットを選ぶ
| 動画 | 形状 | 長さ | 開始 |
|---|---|---|---|
| ショート / Reels / TikTok | 9:16、1080x1920 | 15~35秒 | 最初のフレームにゲームプレイ;ロゴは小さなコーナーバグのみ |
| トレーラー / プロモ | 16:9、1920x1080 | 30~90秒 | スティング(3秒)、その後ベストなゲームプレイ |
| 「どうやって作ったか」ストーリー | 16:9 | 3~6分 | フックとなるセリフ付きのゲームプレイ、その後スティングまたはタイトル |
| チュートリアル(「Playgama MCPで公開する」) | 16:9 | 1~3分/パート | スティング、その後結果を先に、手順は後 |
ショートは最初の1秒で決まります。視聴者はそのまま見るか、スワイプして離れます。フルスクリーンのゲームプレイで始まり、一目でわかるショートは、読むべきもの(長いコメントカード、ゲームメニュー、チャットボックス)で始まるものよりはるかに多くの視聴者を維持します。そのため、ショートはスティングやテキストで始めてはいけません。
ゲームのルック
動画はゲームのように見えます。プレイしたことのある人なら、どのフレームを見てもそれとわかるはずです。ルックはPlaygamaではなく、ゲーム自身から取得します(references/game-look.md):
- 色 UIとコードから:背景、パネル、テキスト、ボタン、ハイライト。コードにテーマがない場合は、
scripts/palette.mjsでメニューやHUDからサンプリングします。 - タイポグラフィ: すべてのフォントがゲームに一致し、コードフォントも含みます。
- タイトルはゲームのタイトルフォントまたはロゴフォント、ラベルとプロンプトはUIまたはテキストフォントを使用します。
- コードとツールコールは、ゲームの精神に沿った等幅フォントを使用します。ピクセルアートにはピクセルフォント、ダーク/レトロゲームにはタイプライターフォント。
- テンプレートのDM Monoはプレースホルダーのみです。
- パネルとボタン: ゲームのパネルの形をしたカード、エンドカードのボタンはゲームのメインボタン、ゲーム自身のアイコンとロゴ。
- モーションとサウンド: ゲームのUIと同じように動かします(バウンス、静か、またはピクセルステップ)。ゲーム自身の音楽とUIサウンドを優先して使用します。
- 黒いスライドではなく、画像の上にカードを置く。 プロンプトやステップはゲームの暗くしたフレームの上に、タイトルはゲームプレイの下の方に、ゲームの背景色で下部を暗くして配置します。名前だけのカードよりも、実際の画像を並べる方を優先します。
色、フォント、パネル形状は、テンプレートのスタイルの先頭にある1つのテーマブロックにまとめます。
ゲームの画像
このキットにはゲームの映像は含まれていません。ゲームのすべての画像は、開発者自身のゲームから、あなたが scripts/film.mjs(references/filming.md)を使って撮影します。これには動画、サムネイル、カードの背景フレーム、レビューページが含まれます。
- クリップ: ビートごとに1テイク。例:
node scripts/film.mjs --url http://localhost:5173 --out clips/gameplay-1.mp4 --seconds 6 - スクリーンショット: 同じコマンドに
--still <seconds>を付けると、その瞬間の1枚のPNGを書き出します。ステップでゲームの画像が必要なときにいつでも取得します。- メニューとHUD(ルックを読み取るため
scripts/palette.mjsで使用); - プロンプトカードやタイトルの背景フレーム;
- サムネイルとエンドカード;
- ゲーム上のスティング(コーナーバグがHUDと重なっていないか確認)。スクリーンショットを
assets/playgama-ai-sting.htmlにドロップするか、最初のクリップをテンプレートに入れてnpx [email protected] snapshot . --at 3.5 --describe falseを実行します。
- メニューとHUD(ルックを読み取るため
- 縦型カット は1080x1920で撮影し、ゲームのカメラをそれ用にリフレームします。
- ゲームがここで実行できない場合(ネイティブビルド、ログイン必須、オンライン専用ゲーム)、開発者に配信サイズの画面録画とスクリーンショットを依頼します。カーソルや通知が画面に表示されていないものに限ります。他のゲーム、ストアページ、このキットのサンプル画像で埋め合わせしないでください。
Playgamaが追加するもの
ロゴとリンクのみ。Playgamaの紫とダークプレートはロゴとスティングに属し、動画には属しません。
- ロゴ は
assets/playgama-ai-logo.svg、公式ファイル:紫色#9747ffのピル型に白いワードマーク、グレー#d2d2d2のボックスに「AI」が切り抜かれています。- そのまま使用します。色を変えたり、引き伸ばしたり、エフェクトを追加したり、間隔を変えたり、再描画したりしないでください。
- 「AI」は穴なので、ロゴの後ろにあるものが透けて見えます。
- ピルの高さの少なくとも半分のクリアスペースを確保します。
- コーナーバグとしては、1920フレームで約200ピクセル幅です。ゲームのHUDがそのコーナーにある場合は、HUDを覆う代わりに別のコーナーにバグを移動します(
references/edit-and-render.md)。
- リンク はPlaygama上のゲーム自身のページに送ります。エンドカードと説明文に配置します。
イントロスティング
Playgamaのアイデンティティ。トレーラーの前のパブリッシャーロゴのようなもの。約3秒、assets/template/index.html に既製のものがあります。すべての動画で独自の色とタイミングを維持します。その後はすべてゲームのものになります。assets/sting-preview.mp4 はプレースホルダーに引き継ぐ様子を示しています。開発者のゲームの上で見るには、ゲームのスクリーンショットまたはクリップを撮影します(「ゲームの画像」参照)。
- 構築: オニキスに柔らかな紫色の光彩。紫色のピルが中央から成長(0.05秒、0.55秒かけて)。白いplaygamaワードマークが左から右へワイプイン(0.42秒)。グレーのボックスがピルの隣にポップイン(0.92秒)、「A」と「I」が切り抜かれる(1.12秒、1.27秒)。光の帯がピルを横切る(1.55秒)。
- ハンドオフ: ロゴ全体が19%サイズで右上隅に飛び、1920×1080フレームの上端と右端から39pxの位置に移動(2.75秒、0.62秒かけて)。バグとしてそこに留まり、その下でゲームプレイがフェードイン(3.0秒)。
- パーツ は公式ファイルの形状から240pxの高さで描画されるため、スティングは正確にロゴで終わります。
- 変更: タイミングは維持します。最初にコールドオープン(ストーリー)を入れる場合は、スティングを後から開始します。テンプレートで
Sを設定します(references/edit-and-render.md)。9:16カットの場合は、構築を省略し、1フレーム目からコーナーのバグを開始します。
失敗から得たルール
- 画面には実際の素材のみ。
- 実際のプロンプト、実際の数値、実際のタイムスタンプ、実際のコードを表示します。
- 数値を例示的に示す必要がある場合は、表示中ずっと画面上に「EXAMPLE DATA」と明記します。
- 引用、コメント、プレイヤー数、レビューを決して捏造しないでください。捏造された数値を確認した視聴者は、残りを信頼しなくなります。
- 画面のプロンプトは開発者の言葉そのもの。
- 動画の言語に翻訳しますが、言い換えてはいけません。
- 長いものは「[…]」で切り詰めます。要約してはいけません。
- エージェントのステップは、実際のツールコールを実際の順序で表示します。例:
create_application→start_archive_upload→get_archive_status(PASSED) →publish_sandbox(公開リンク)。
- 自分のアートだけ。 他のゲームのキャラクター、ロゴ、アートを表示しないでください。自ゲームが「〜に似ている」場合でも、他のゲーム名ではなくジャンル名を挙げてください(「ホラー脱出ゲーム」など)。
- Playgamaは「プレイガーマ」と発音します。 英語の音声は「プレイゲイマ」と言ってしまうため、修正が必要です(
references/voice-and-music.md)。 - ナレーションのテイクはすべてテキストと照合し、人間が聞いて確認する。 テキスト読み上げは、文の繰り返し、誰も書いていない文の追加、自分の指示の読み上げ、最後の音節の欠落などを、単体では問題なく聞こえるテイクで起こします。
- 最初のゲームプレイフレームは1秒未満で認識できるもの。メニューやローディング画面ではない。
- ショートはそれで始まります。トレーラーやストーリーは、スティングまたはコールドオープンの直後にそれに到達します。
- 最高の瞬間を撮影します。レベルの始まりではありません。
- ゲームプレイの最初の2秒間のテキストは、最大4つの大きな単語まで。
- 映像はマシン上に留める。 HyperFramesの
snapshotは、GeminiまたはGoogleキーが設定されていると、フレームを説明のためにGeminiに送信します。また、ビデオフォルダ内の.envを読み取ります。すべてのsnapshotに--describe falseを渡し、音声キーはビデオフォルダではなくvoice.mjsの共有キーファイルに保持してください。
完了時
開発者には以下を提供します:
- マスターMP4、およびサイズが大きい場合は小さなプレビュー版;
- サムネイル;
- タイトル、説明文(ゲームのリンク、長い動画のチャプター、
#playgama)、ピン留めするコメントを記載したテキストファイル。
各ファイルがどこにあるか、そしてまだ開発者が決定すべきこと(投稿時間、まだ聞いていないナレーションテイク、確認できなかったこと)を伝えます。