docs-demo について
ドキュメントに Remotion のインタラクティブなコンポジションを追加するリポジトリ向けスキルです。React デモの作成、再生設定やコントロールの登録、MDX への埋め込みを案内します。
主な機能
- 01React デモコンポーネントの作成
- 02デモ情報の登録
- 03インタラクティブな操作項目
- 04デモ一覧への登録
- 05MDX への埋め込み
活用シーン
- 01ドキュメントへの再生可能なコンポジション追加
- 02デモパラメーターの操作項目化
- 03登録済みデモの MDX への埋め込み
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ remotion-dev/ remotion --skill docs-demoインストール後、Claude Code で/docs-demoを入力して読み込まれたか確認します。
詳細
ドキュメントにインタラクティブデモを追加する
インタラクティブデモは、@remotion/player を使ってドキュメントページ内に Remotion コンポジションをインラインで表示します。packages/docs/components/demos/ に配置します。
エフェクトデモは別の仕組みです。<EffectsDemo type="effects-..." /> を使用し、汎用的な <Demo> のオプション配列ではなく、実際のエフェクトの schema を使って packages/docs/components/effects-demos/registry.ts に登録してください。
手順
-
コンポーネントを作成する:
packages/docs/components/demos/に作成します(例:MyDemo.tsx)。useCurrentFrame()やuseVideoConfig()などの Remotion フックを使用する標準的な React コンポーネントにしてください。 -
デモを登録する:
packages/docs/components/demos/types.tsに登録します。- コンポーネントをインポートします
- 次のフィールドを持つ
DemoTypeオブジェクトをエクスポートします。id:<Demo type="..." />で使用する一意の文字列comp:React コンポーネントcompWidth/compHeight:キャンバスのサイズ(例:1280x720)fps:フレームレート(通常は30)durationInFrames:アニメーションの長さautoPlay:自動再生するかどうかoptions:インタラクティブコントロールの配列(空の[]でも可)
-
デモ配列に追加する:
packages/docs/components/demos/index.tsxに追加します。./typesからデモ定数をインポートしますdemos配列に追加します
-
MDX で使用する:
<Demo type="your-id" />
オプション
オプションを追加すると、プレーヤーの下にインタラクティブコントロールが表示されます。各オプションには name と optional('no'、'default-enabled'、または 'default-disabled')が必要です。
対応している型は次のとおりです。
type: 'numeric'—min、max、step、defaultを指定するスライダーtype: 'boolean'—defaultを指定するチェックボックスtype: 'enum'—values配列とdefaultを指定するドロップダウンtype: 'string'—defaultを指定するテキスト入力
オプションの値は inputProps としてコンポーネントに渡されます。通常の React プロパティとしてアクセスできます。
登録例
export const myDemo: DemoType = {
comp: MyDemoComp,
compHeight: 720,
compWidth: 1280,
durationInFrames: 150,
fps: 30,
id: 'my-demo',
autoPlay: true,
options: [],
};