Flutter デモリール
Flutterアプリの短いループプロモーション動画を、そのアプリ専用のmacOS用Flutterアプリとして
<flutter app>/demo に構築し、フレームごとにオフラインレンダリングしてエンコードします。
リールはアプリの実際の画面、アート、フォント、コンテンツを使用し、flutter_scene(Metal上のFlutter GPU)による3Dレイヤー、
2Dパーティクル&タイトルキット、音楽に同期したカットを備えています。
以下のパスは、このスキルが含まれるフォルダ(このSKILL.mdが置かれているフォルダ)からの相対パスです。
Claude Codeでは、そのフォルダは ${CLAUDE_SKILL_DIR} です。
基本ルール
- アプリを決して変更しないでください。 必要なもの(アート、フォント、スクリーンショット、コンテンツデータ、テーマカラー)は
demo/にコピーしてください。scaffoldはdemo/**を親パッケージのアナライザの除外対象に追加するだけです。 - すべてのフレームは
tの純粋関数です。 フレーム間の状態、Random()、クロック、シミュレーションは禁止:閉じた形式のモーション、シード付き乱数を使用します。これにより、シーク、チャンク書き出し、モーションブラー、シームレスループが可能になります。ショットを書く前に references/kit.md を読んでください。 - プロジェクトの音声ルール(AGENTS.md、CLAUDE.md など)に従ってください。 アプリが決して使わない単語、製品の自称、トーン。
- 構築前に同意を得てください。 ユーザーにインタビューし、承認されるスクリプトを書いてください。
- macOSのみ。 Flutter(macOSデスクトップ対応)、ffmpeg(
brew install ffmpeg)、Python 3(Pillow:コンタクトシート、numpy:音声解析)が必要です。
ワークフロー
1. インタビュー
始める前に、各項目にデフォルトを提示してユーザーが素早く回答できるように質問してください。
- 長さとループ(デフォルト30秒、シームレスループ)、フォーマット(ランドスケープ1920x1080、ポートレート1080x1920(Reels、TikTok、Shorts向け))、60fps。
- サウンドトラック:ファイル(歌詞あり?)またはなし、権利の所有者。
- メッセージ:表示する3~5項目、コールトゥアクション(URL、ストアバッジ)、主張する点(無料?評価?カウント?)。
- 見た目とトーン:派手さの度合い、アプリのブランド、参考資料。
- 実際の画面:どれか、アプリを実行してキャプチャしてよいか(テストアカウント、シードデータ)。架空の雰囲気ショットも?
- 画面上のテキスト:キーワードのみ(デフォルト)か完全なキャプションか、製品名のスペル、避けるべき単語。
- 特別なもの:イースターエッグ、キャラクター、絶対に表示してはいけないもの。
2. アプリを調査する
アプリのテーマ(色、フォント)、アセット(ロゴ、キャラクター、アイコン)、コンテンツ(実際の名前、数値、表示するデータ)、メイン画面を読み取ります。特徴的な点をメモします。スクリーンショットを計画してキャプチャするか、ユーザーに依頼します(references/craft.md の「実際のスクリーンショット」を参照)。
3. サウンドトラックを分析する
python3 scripts/analyze_audio.py <track>
テンポ、ビート位相、セクション、ボーカルラインを名前付きキューに変換します(references/audio-sync.md を参照)。サウンドトラックがない場合でも、テンポを選び、そのグリッドに合わせてカットします。
4. スクリプトを書く
各ショットについて、音楽または歌詞、ランドスケープ画像、ポートレート画像、画面上のテキストを記したタイムテーブルを作成します(テンプレートは references/craft.md にあります)。フック、ドロップ、エンドカード、ループの継ぎ目をマークします。ユーザーの承認を得て、ゴーサインが出るまで繰り返します。
5. スキャフォールド
zsh scripts/scaffold.sh <flutter app dir>
このスキルの scripts/ フォルダへのフルパスを指定して実行します(どのディレクトリからでも動作します)。
<app>/demoをflutter create --platforms macosで作成します。- flutter_scene、vector_math、audioplayers を追加し、
flutter_scene:initを実行します。 - Flutter GPU を有効化(
FLTEnableFlutterGPU)、アプリサンドボックスを無効化(書き出し時にffmpegを実行するため)。 assets/template/からスターターキットをコピー、art/、art/screens/、audio/、fonts/を作成、out/を無視します。- 親パッケージのアナライザから
demo/**を除外します。
pub workspaces 内でも機能し(デモはスタンドアロンパッケージのまま)、既存のフォルダを上書きしません。
次に設定します。
lib/core/timeline.dart:kDuration、kBpm、kBeatPhase、Cue。lib/core/format.dart:アプリのテーマからのPalette、Fonts(フォントファイルをdemo/fonts/にコピーし、pubspec.yamlで宣言)。- アセット:
art/(pubspec.yamlでサブフォルダをリスト)、audio/track.wav(48kHz PCM)。
一度ビルドして、サンプルのスチルをレンダリングし、設定が機能することを確認します。
cd <app>/demo && flutter build macos --profile && tool/run.sh stills "0.3,2.3,9" both
6. リールを構築する
lib/shots/example.dart をスクリプトの各パートごとのセクションに置き換え、Director.sections にリストし、Director._hits でカメラヒットを設定します。セクションごとに作業します。
- キット(references/kit.md)と flutter_scene(references/flutter-scene.md)を使用してセクション(3Dフレーム、その上下の2Dレイヤー)を書きます。
flutter build macos --profileを実行し、セクションのキーモーメントでスチルを両方のフォーマットでレンダリングします:tool/run.sh stills "t1,t2,..." both。- フォーマットごとに1つのコンタクトシートを作成し、詳細が重要な箇所はシングルスチルを拡大して検査します:
python3 tool/sheet.py out/l.png 4 480 out/stills/landscape_*.png。画像を表示できない場合は、どのスチルを確認すべきか、何を探すべきかをユーザーに伝えます。修正して繰り返します。
書き出す前に、references/craft.md のレビューチェックリスト全体をリールに対して実行します。ユーザーはプレビューアプリで音楽とともに視聴できます(open build/macos/Build/Products/Profile/*.app)。スチルではタイミングを確認できません。
7. 書き出し
tool/export.sh draft both # 1倍、モーションブラーなし:クイック全体チェック
tool/export.sh final both # 2倍スーパーサンプル、4サンプルモーションブラー
最終書き出しは、30秒の場合、フォーマットあたり約10~15分かかります。環境が許せばバックグラウンドで実行し、ポーリングはしないでください。その後、ffprobe でファイルを確認します:フレーム数が kDuration * kFps であること、長さが正しいこと、オーディオストリームがあること。MP4から数フレームを抽出します(最終フレームとフレーム0(ループの継ぎ目)を含む)。
8. 納品と反復
ユーザーにパス(アップロード用は demo/out/final/<format>.mp4、編集用は <format>_master.mov ProRes)、ファイルサイズ、確認すべき点を伝えます。フィードバックを期待します。references/craft.md に典型的な修正例があります:テキストの表示時間が短すぎる、テキストが隠れている、不要な字幕、アウトラインの継ぎ目、ハードな光線、同じに見えるアイテム群、ポートレートの文言。再レンダリング前にすべてのフィードバックをラウンドで修正します。
ファイル
- references/kit.md:スターターキットのアーキテクチャとAPI。
- references/flutter-scene.md:flutter_sceneのセットアップ、見た目、オフラインの注意点。
- references/audio-sync.md:トラックからのテンポ、位相、歌詞、キュー。
- references/craft.md:スクリプトテンプレート、テキストルール、エフェクトレシピ、スクリーンショット、レビューチェックリスト。
scripts/scaffold.sh:デモアプリを作成します。scripts/analyze_audio.py:テンポ、ビート位相、バーあたりのラウドネス、オンセット。assets/template/:scaffoldがコピーするスターターキット。