Remotion Controls Skill
コードでビデオアニメーションを駆動するプロフェッショナル制御スキル。Remotion は React ベースの動画作成フレームワークであり、コードで各フレームを正確に制御し、透明背景のレンダリングをネイティブでサポートします。
コア機能
| 機能 | 説明 |
|---|---|
| 透明背景レンダリング | アルファチャンネルをネイティブサポート。WebM(VP9) / MOV(ProRes 4444) で透明動画を出力 |
| コードによる精密制御 | React/TypeScript で位置、スケール、回転、透明度、イージングカーブを正確に制御 |
| APIサービス化 | HTTP API でアニメーション指示を受け取り、動画ファイルを出力 |
| テンプレートライブラリ | プリセットアニメーションテンプレート(キャラクターアニメーション、UIアニメーション、テキストアニメーション、トランジションエフェクト) |
| 品質管理 | フレームレート、解像度、ビットレート、アルファチャンネルの完全性を自動検出 |
| 自己学習進化 | レンダリングパラメータと効果スコアを記録し、プリセットパラメータを最適化 |
ComfyUI / Blender とのポジショニングの違い
| スキル | コアアドバンテージ | 適用シーン |
|---|---|---|
| ComfyUI-controls | AI生成(画像/動画/音声)、クリエイティブ制御不可 | キャラクター画像/シーン画像/エフェクト動画生成 |
| Blender-controls | 3Dアニメーション、物理シミュレーション、高品質レンダリング | 3Dキャラクターアニメーション、プロダクトプレゼンテーション、物理エフェクト |
| Remotion-controls | 2Dコードアニメーション、精密制御可能、透明背景 | テンプレートアニメーション素材、UIアニメーション、テキストタイポグラフィ、2Dキャラクターアニメーション |
クイックスタート
1. 依存関係のインストール
cd remotion-project
npm install
2. 透明背景動画のレンダリング
# CLI 方式
npx remotion render src/index.ts MyComp out/video.webm --transparent
# API 方式
python remotion_controls.py render --composition MyComp --output out/video.webm --transparent
3. API サービスの起動
python remotion_controls.py serve --port 8765
透明背景レンダリングの説明(検証済みフロー)
Remotion は透明背景をネイティブサポートしていますが、CLI の --transparent エンコードではアルファチャンネルが失われます(WebM VP8/VP9、MOV ProRes で確認済み)。
検証済みの正しいフロー(PIT-024):
- PNGシーケンスレンダリング:
npx remotion render src/index.ts Composition out/frames --sequence(アルファ付きPNGシーケンスを出力) - ffmpegでProRes 4444に合成:
ffmpeg -y -framerate 30 -i out/frames/%04d.png \ -c:v prores_ks -profile:v 4 -pix_fmt yuva444p12le \ out/animation.mov - アルファチャンネルの検証:
python verify_animation.py out/animation.mov
剪映統合に関する注意事項(PIT-024):
add_media_safeで ProRes 4444 mov をインポートすると自動的に H.264 mp4 にトランスコードされ、アルファが失われます(66MB→0.07MB)- 手動インポートが必要:mov を直接草稿 materials ディレクトリにコピー → VideoMaterial を作成 → materials.videos に登録 → VideoSegment(material=anim_material) → add_segment
アニメーション素材品質基準
完全な基準は QUALITY_STANDARD.md を参照してください。
合格アニメーション素材の必須指標:
- アルファチャンネル保持(yuva444p12le)
- ProRes 4444 エンコード(profile=4)
- 解像度/フレームレート/持続時間が設定と一致
- コンテンツカバレッジ ≥ 50%(10ポイントサンプリング)
- ファイルサイズが適切(≤15MB/秒)
自動検証:
python verify_animation.py <アニメーションファイル> --duration 20 --width 1080 --height 1920
基本アニメーションコンポーネントライブラリ
remotion-project/src/components/ にあり、すべてのコンポーネントが透明背景をサポートしています。
キャラクターとモーションコンポーネント
| コンポーネント | 説明 |
|---|---|
| CharacterSprite | キャラクタースプライト:複数ポーズ切替、位置/スケール/回転/透明度のキーフレームアニメーション |
| MotionPath | モーションパス:線形/ベジェ/弾性/バウンス運動 |
| FlashEffect | フラッシュエフェクト:高速フェードイン、低速フェードアウト |
| ShakeEffect | シェイクエフェクト:振幅減衰するランダム振動 |
| FadeEffect | フェードイン/アウト:制御可能なフェードイン/アウト時間 |
| PopEffect | ポップエフェクト:弾性スケーリングによるポップ表示 |
| SlideEffect | スライドエフェクト:4方向イーズアウトスライド |
テキストアニメーションコンポーネント(TextAnimations.tsx)
| コンポーネント | 説明 | 適用シーン |
|---|---|---|
| TextReveal | 文字ごとの表示:タイプライター/フェードイン/スライドアップ/スライドレフト | ナレーション、セリフ、タイトル登場 |
| TextPop | ポップテキスト:スケール/回転/バウンス | キーワード強調、ビート合わせ |
| TextWave | ウェーブテキスト:文字ごとのサイン波浮遊 | 遊び心のあるスタイル、BGMリズム |
| TextGlitch | グリッチエフェクト:RGB分離+震え | テクノロジー感、グリッチアート、トランジション |
| TextGradient | グラデーションフロー:色の流れ+スキャンライト | タイトル、ブランド名、高級感 |
| KineticText | キネティックタイポグラフィ:複数行の組み合わせアニメーション | オープニングタイトル、エンドロール |
トランジションエフェクトコンポーネント(TransitionEffects.tsx)
| コンポーネント | 説明 | 適用シーン |
|---|---|---|
| FadeTransition | フェードイン/アウトトランジション(in/out/inOut) | 汎用トランジション、感情の移行 |
| SlideTransition | スライドトランジション(上下左右) | シーン切り替え、コンテンツ置換 |
| ZoomTransition | ズームトランジション(押し出し/引き寄せ) | 重点強調、レンズの推進 |
| WipeTransition | ワイプトランジション(上下左右/対角線) | クリエイティブトランジション、スタイル化 |
| BlurTransition | ブラートランジション(ぼかし→鮮明) | 夢幻的な移行、回想フラッシュバック |
| GlitchTransition | グリッチトランジション(RGB分離+走査線) | テクノロジー感、グリッチアート |
インパクトエフェクトコンポーネント(ImpactEffects.tsx)
| コンポーネント | 説明 | 適用シーン |
|---|---|---|
| PunchImpact | パンチインパクト(衝撃波+星+フラッシュ) | 格闘、打撃、衝突 |
| ImpactFlash | インパクトフラッシュ(高速フラッシュ) | 強打、爆発、ビート合わせ |
| ParticleBurst | パーティクルバースト(星/火花/破片) | 祝福、爆発、衝撃 |
| Shockwave | ショックウェーブ(複数リング拡散) | エネルギー放出、爆発、振動感 |
| SpeedLines | スピードライン(放射状) | 高速衝撃、ダッシュ、連打 |
使用例:
import { PunchImpact, ParticleBurst, FadeTransition } from "./components";
// 格闘シーン
<PunchImpact startFrame={90} x={540} y={800} scale={1.2} />
<ParticleBurst startFrame={90} x={540} y={800} count={16} particleType="star" />
<FadeTransition direction="in" duration={15} startFrame={0} color="#1a1a2e" />
使用例:
import { CharacterSprite, FlashEffect, TextReveal, TextPop } from "./components";
<CharacterSprite
poses={[
{ name: "idle", image: "/doubao_normal.png", frameRange: [0, 90],
position: [{frame: 0, x: 0, y: 0}, {frame: 90, x: 100, y: 0}] },
{ name: "falling", image: "/doubao_falling.png", frameRange: [90, 150] },
]}
width={250} height={250}
/>
<FlashEffect startFrame={90} duration={10} />
<TextReveal text="被打った!" fontSize={56} startFrame={95} revealType="typewriter" />
<TextPop text="痛い!" fontSize={72} color="#ff6b6b" startFrame={110} popType="bounce" />
プロジェクト構造
remotion-controls-skill/
├── SKILL.md # 本ファイル
├── QUALITY_STANDARD.md # アニメーション素材品質基準
├── verify_animation.py # 自動検証ツール
├── remotion_controls.py # メイン制御スクリプト(CLI/API)
├── .env.example # 環境変数例
├── .gitignore
├── capabilities/
│ ├── cap_api_wrapper/ # Remotion API ラッパー
│ ├── cap_animation_renderer/ # アニメーションレンダラー
│ ├── cap_template_library/ # アニメーションテンプレートライブラリ
│ ├── cap_quality_control/ # 品質管理
│ └── cap_self_evolution/ # 自己学習進化
├── remotion-project/ # Remotion プロジェクト
│ ├── src/
│ │ ├── components/ # 基本アニメーションコンポーネントライブラリ
│ │ │ ├── CharacterSprite.tsx
│ │ │ ├── MotionPath.tsx
│ │ │ ├── Effects.tsx
│ │ │ └── index.ts
│ │ ├── AnimationTemplate.tsx # JSON駆動のアニメーションテンプレート
│ │ ├── Root.tsx
│ │ └── index.ts
│ ├── public/ # 静的素材(キャラクター/小道具画像)
│ └── package.json
└── out/ # レンダリング出力
機能モジュール
cap_api_wrapper — Remotion API ラッパー
render_media():動画レンダリング(透明背景対応)render_still():単一フレーム画像レンダリングselect_composition():利用可能な Composition のリスト取得get_props_schema():Composition の Props 定義取得
cap_animation_renderer — アニメーションレンダラー
- アニメーション指示 JSON を入力 → 透明背景動画を出力
- キーフレームアニメーション対応(位置/スケール/回転/透明度)
- イージングカーブ対応(ease-in/ease-out/ease-in-out/linear/spring)
- 複数レイヤー合成対応
cap_template_library — アニメーションテンプレートライブラリ
- キャラクターアニメーションテンプレート(豆包被打、表情切替など)
- UIアニメーションテンプレート(ボタンクリック、ページ切替など)
- テキストアニメーションテンプレート(タイプライター、フェード、バウンスなど)
- トランジションエフェクトテンプレート(フェード、スライド、ズームなど)
cap_quality_control — 品質管理
- フレームレート検出(24/30/60fps)
- 解像度検出(1080p/4K)
- アルファチャンネル完全性検出
- 動画時間と期待値の比較
- ファイルサイズ妥当性チェック
cap_self_evolution — 自己学習進化
- レンダリングパラメータと効果スコアを記録
- プリセットパラメータの最適化
- ベストプラクティスドキュメントの生成
- テンプレート効果ランキング
環境変数
REMOTION_PROJECT_PATH=./remotion-project
REMOTION_OUTPUT_DIR=./output
REMOTION_DEFAULT_FPS=30
REMOTION_DEFAULT_WIDTH=1080
REMOTION_DEFAULT_HEIGHT=1920
REMOTION_API_PORT=8765
ai-video-editor との統合
Remotion-controls-skill は ai-video-editor のアニメーション素材作成ツールとして機能します:
- ai-video-editor のディレクターエンジンがアニメーション指示を出力
- Remotion-controls-skill が指示を受け取り、透明背景動画をレンダリング
- 透明背景動画が剪映テンプレートのアニメーション素材レイヤーとして使用される
- ユーザーが背景を差し替えると、アニメーションが完璧に重なる
注意事項
- Remotion には Node.js 18+ 環境が必要です
- 透明背景動画には WebM 形式を推奨(剪映との互換性が良好)
- 長時間動画のレンダリングには時間がかかるため、分割レンダリング後に合成することを推奨
- アニメーション内で CSS フィルターは使用しないでください(一部のフィルターは透明背景をサポートしません)