Remotion — ツールキット拡張
Remotionのコア知識は
.claude/skills/remotion-official/(公式 remotion-dev/skills リポジトリから同期)にあります。このファイルは ツールキット固有の パターンのみを扱います。
共有コンポーネント
lib/components/ にある再利用可能な動画コンポーネント。テンプレートでインポート:
import { AnimatedBackground, SlideTransition, Label } from '../../../../lib/components';
| コンポーネント | 目的 |
|---|---|
AnimatedBackground | フローティングシェイプの背景(バリエーション: subtle, tech, warm, dark) |
SlideTransition | シーン遷移(fade, zoom, slide-up, blur-fade) |
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
トランジション例
// テック/サイバーパンク風
glitch({ intensity: 0.8, slices: 8, rgbShift: true })
// 温かいお祝い
lightLeak({ temperature: 'warm', direction: 'right' })
// ハイエナジーズーム
zoomBlur({ direction: 'in', blurAmount: 20 })
// 色収差
rgbSplit({ direction: 'diagonal', displacement: 30 })
// 時計回りリビール
clockWipe({ direction: 'clockwise', startAngle: 0 })
// レトロピクセル化
pixelate({ maxBlockSize: 50, glitchArtifacts: true })
// チェッカーボードパターン
checkerboard({ pattern: 'diagonal', gridSize: 8 })
checkerboard({ pattern: 'spiral', gridSize: 10 })
checkerboard({ pattern: 'center-out', squareAnimation: 'scale' })
トランジション時間ガイドライン
| タイプ | フレーム数 | メモ |
|---|---|---|
| クイックカット | 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 の更新を案内します。