Remotion — ツールキット拡張機能
コアRemotion知識は
.claude/skills/remotion-official/(公式 remotion-dev/skills リポジトリから同期)にあります。このファイルは ツールキット固有のパターンのみをカバーします。
共有コンポーネント
lib/components/ 内の再利用可能なビデオコンポーネント。テンプレートにインポートするには:
import { AnimatedBackground, SlideTransition, Label } from '../../../../lib/components';
| コンポーネント | 目的 |
|---|---|
AnimatedBackground | 浮遊形状の背景(バリアント:微妙、テック、温かみ、ダーク) |
SlideTransition | シーントランジション(フェード、ズーム、スライドアップ、ぼかしフェード) |
Label | オプションのJIRA参照付きフローティングラベルバッジ |
Vignette | 映画的なエッジ暗転オーバーレイ |
LogoWatermark | コーナーロゴブランディング |
SplitScreen | サイドバイサイドのビデオ比較 |
NarratorPiP | ピクチャーインピクチャーのプレゼンターオーバーレイ |
Envelope | 開閉フラップアニメーション付き3D封筒 |
PointingHand | スライドインとパルス効果付きアニメーションハンド絵文字 |
MazeDecoration | コーナー用のアニメーション等角グリッド装飾 |
カスタムトランジション
ツールキットには、公式の @remotion/transitions パッケージを超えるシーン間エフェクトのためのトランジションライブラリが lib/transitions/ に含まれています。
TransitionSeriesの使用
import { TransitionSeries, linearTiming } from '@remotion/transitions';
// libからカスタムトランジションをインポート(プロジェクトの場所に応じてパスを調整)
import { glitch, lightLeak, clockWipe, checkerboard } from '../../../../lib/transitions';
// または公式のものを@remotion/transitionsからインポート
import { slide, fade } from '@remotion/transitions/slide';
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={90}>
<TitleSlide />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={glitch({ intensity: 0.8 })}
timing={linearTiming({ durationInFrames: 30 })}
/>
<TransitionSeries.Sequence durationInFrames={120}>
<ContentSlide />
</TransitionSeries.Sequence>
</TransitionSeries>
利用可能なカスタムトランジション
| トランジション | オプション | 最適な用途 |
|---|---|---|
glitch() | intensity, slices, rgbShift | テックデモ、エッジの効いたリビール、サイバーパンク |
rgbSplit() | direction, displacement | モダンテック、エネルギッシュなトランジション |
zoomBlur() | direction, blurAmount | CTA、高エネルギーモーメント、インパクト |
lightLeak() | temperature, direction | お祝い、フィルム美学、温かみのある瞬間 |
clockWipe() | startAngle, direction, segments | 時間関連コンテンツ、遊び心のあるリビール |
pixelate() | maxBlockSize, gridSize, scanlines, glitchArtifacts, randomness | レトロ/ゲーミング、デジタルトランスフォーメーション |
checkerboard() | gridSize, pattern, stagger, squareAnimation | 遊び心のあるリビール、構造化されたトランジション |
チェッカーボードパターン: sequential, random, diagonal, alternating, spiral, rows, columns, center-out, corners-in
トランジション例
// テック/サイバーパンク感
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={90}>
<TitleSlide />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={glitch({ intensity: 0.8, slices: 8, rgbShift: true })}
timing={linearTiming({ durationInFrames: 30 })}
/>
<TransitionSeries.Sequence durationInFrames={120}>
<ContentSlide />
</TransitionSeries.Sequence>
</TransitionSeries>
// 温かみのあるお祝い
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={90}>
<TitleSlide />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={lightLeak({ temperature: 'warm', direction: 'right' })}
timing={linearTiming({ durationInFrames: 45 })}
/>
<TransitionSeries.Sequence durationInFrames={120}>
<ContentSlide />
</TransitionSeries.Sequence>
</TransitionSeries>
// 高エネルギーズーム
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={60}>
<TitleSlide />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={zoomBlur({ direction: 'in', blurAmount: 20 })}
timing={linearTiming({ durationInFrames: 30 })}
/>
<TransitionSeries.Sequence durationInFrames={90}>
<ContentSlide />
</TransitionSeries.Sequence>
</TransitionSeries>
// 色収差
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={90}>
<TitleSlide />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={rgbSplit({ direction: 'diagonal', displacement: 30 })}
timing={linearTiming({ durationInFrames: 30 })}
/>
<TransitionSeries.Sequence durationInFrames={120}>
<ContentSlide />
</TransitionSeries.Sequence>
</TransitionSeries>
// 時計回りスイープリビール
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={90}>
<TitleSlide />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={clockWipe({ direction: 'clockwise', startAngle: 0 })}
timing={linearTiming({ durationInFrames: 30 })}
/>
<TransitionSeries.Sequence durationInFrames={120}>
<ContentSlide />
</TransitionSeries.Sequence>
</TransitionSeries>
// レトロピクセル化
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={90}>
<TitleSlide />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={pixelate({ maxBlockSize: 50, glitchArtifacts: true })}
timing={linearTiming({ durationInFrames: 30 })}
/>
<TransitionSeries.Sequence durationInFrames={120}>
<ContentSlide />
</TransitionSeries.Sequence>
</TransitionSeries>
// チェッカーボードパターン
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={90}>
<TitleSlide />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={checkerboard({ pattern: 'diagonal', gridSize: 8 })}
timing={linearTiming({ durationInFrames: 30 })}
/>
<TransitionSeries.Sequence durationInFrames={120}>
<ContentSlide />
</TransitionSeries.Sequence>
</TransitionSeries>
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={90}>
<TitleSlide />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={checkerboard({ pattern: 'spiral', gridSize: 10 })}
timing={linearTiming({ durationInFrames: 30 })}
/>
<TransitionSeries.Sequence durationInFrames={120}>
<ContentSlide />
</TransitionSeries.Sequence>
</TransitionSeries>
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={90}>
<TitleSlide />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={checkerboard({ pattern: 'center-out', squareAnimation: 'scale' })}
timing={linearTiming({ durationInFrames: 30 })}
/>
<TransitionSeries.Sequence durationInFrames={120}>
<ContentSlide />
</TransitionSeries.Sequence>
</TransitionSeries>
トランジションの長さの目安
| タイプ | フレーム数 | 注釈 |
|---|---|---|
| クイックカット | 15-20 | 速く、パンチのある印象 |
| 標準 | 30-45 | 最も一般的 |
| 劇的 | 50-60 | ゆっくりとしたリビール |
| グリッチ効果 | 20-30 | 突然感が必要 |
| ライトリーク | 45-60 | スイープする時間が必要 |
トランジションのプレビュー
すべてのトランジションを確認するには、ショーケースギャラリーを実行します:
cd showcase/transitions && npm run studio
ツールキットのベストプラクティス
- フレームベースのアニメーションのみ — CSSトランジション/アニメーションは避けてください。レンダリング中にちらつきの原因になります。
- useVideoConfig()のfpsを使用 — アニメーションをフレームレートに依存しないようにします。
- 補間をクランプ —
extrapolateRight: 'clamp'を使用して、値が暴走するのを防ぎます。 - OffthreadVideoを使用 — 複雑なコンポジションでは
<Video>よりもパフォーマンスが優れています。 - 非同期処理にはdelayRender — データが準備できるまで常にレンダリングをブロックします。
- アセットにはstaticFile —
public/フォルダからファイルを正しく参照します。 - すべてのプロジェクトは30fpsを使用 — タイミング:フレーム数 = 秒数 × 30。
- playbackRateは一定に — 可変/極端な速度の場合は、FFmpegで事前処理します。
プロジェクトタイミング規約
| シーンタイプ | 時間 | 注釈 |
|---|---|---|
| タイトル | 3-5秒 (90-150f) | ロゴ + 見出し |
| 概要 | 10-20秒 | 3-5個の箇条書き |
| デモ | 10-30秒 | 収まるようにplaybackRateを調整 |
| 統計 | 8-12秒 | 3-4個の統計カード |
| クレジット | 5-10秒 | クイックフェード |
ペーシング: ナレーションは約150語/分。ナレーションがタイミングを決定します。
高度なAPI
すべてのフック、コンポーネント、レンダラー、Lambda、Player APIの詳細なAPIドキュメントについては、reference.md を参照してください。
ライセンスに関する注意
Remotionには特別なライセンスがあります。企業は商用利用のためにライセンスを取得する必要がある場合があります。https://remotion.dev/license を確認してください。
フィードバックと貢献
このスキルに情報が不足している、または改善できる点がある場合:
- パターンが不足していますか? 必要なものを説明してください。
- エラーを見つけましたか? 問題がある箇所をお知らせください。
- 貢献したいですか? 以下の手順をお手伝いします:
- このスキルを改善内容で更新
- github.com/digitalsamba/claude-code-video-toolkit にPRを作成
「このスキルを改善してください」と言っていただければ、.claude/skills/remotion/SKILL.md の更新をガイドします。