這是編寫 Remotion React 標記的指導方針。 如果這不相關,請改為載入 Remotion 最佳實踐。
通用規則
使用 useCurrentFrame() 和 interpolate() 來動畫化屬性。
優先使用 interpolate() 而非 spring()。
使用 Easing.bezier() 來自訂時間曲線,包含跳躍或 overshoot 的運動。
若需要彈簧動畫,則使用 Easing.spring()。
在 Studio 中需要互動的 HTML 元素應使用 Interactive:<div> 改為 <Interactive.Div>。
為 Interactive、Solid、Sequence 設定描述性的 name 屬性,例如 name="Hero title"。
import { useCurrentFrame, Easing, interpolate, Interactive } from "remotion";
export const FadeIn = () => {
const frame = useCurrentFrame();
return (
<Interactive.Div
name="Title"
style={{
opacity: interpolate(frame, [0, 60], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
}}
>
Hello World!
</Interactive.Div>
);
};
將 interpolate() 呼叫內聯寫在 style 屬性中。
優先使用 scale、translate、rotate 這類 CSS 屬性,而非 transform。
// 👍 內聯可編輯的關鍵影格與 transform 簡寫
style={{
scale: interpolate(frame, [0, 100], [0, 1]),
translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}
// 👎 隱藏的值與 transform 字串在 Studio 中較難編輯
const scale = interpolate(frame, [0, 100], [0, 1]);
style={{
transform: `scale(${scale})`,
}}
CSS 過渡或動畫是禁止的——它們無法正確渲染。 Tailwind 動畫類別名稱是禁止的——它們無法正確渲染。
將素材放在專案根目錄的 public/ 資料夾中。
使用 staticFile() 來引用 public/ 資料夾中的檔案。
使用 @remotion/media 來加入影片和音訊。
使用 <Img> 元件來加入圖片。
對於 public/ 中的檔案使用 staticFile(),或直接傳入遠端 URL:
import { Audio, Video } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return (
<>
<Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />
<Audio src={staticFile("audio.mp3")} />
<Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />
<Video src="https://remotion.media/video.mp4" />
</>
);
};
若要延遲內容,請將其包裹在 <Sequence> 中並使用 from。
若要限制元素的持續時間,請使用 <Sequence> 的 durationInFrames。
<Sequence> 預設為絕對填滿並覆蓋整個場景。
對於內嵌內容,請使用 layout="none"。
const Main = () => {
const {fps} = useVideoConfig();
return (
<AbsoluteFill>
<Sequence name="Background">
<Background />
</Sequence>
<Sequence name="Title" from={30} durationInFrames={60} layout="none">
<Title />
</Sequence>
<Sequence name="Subtitle" from={60} durationInFrames={60} layout="none">
<Subtitle />
</Sequence>
</AbsoluteFill>
);
}
export const Title = () => {
const frame = useCurrentFrame();
return (
<div
style={{
opacity: interpolate(frame, [0, 60], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
}}
>
Title
</div>
);
};
export const Subtitle = () => {
return <div>Subtitle</div>;
};
文字高亮與註釋
請參閱 text-highlights.md 了解文字高亮(高亮標記)、圓圈、底線、刪除線、劃掉文字、方框與括號。
旁白
請參閱 voiceover.md 了解如何使用 ElevenLabs TTS 為 Remotion 作品添加 AI 生成的旁白。
修剪
請參閱 trimming.md 了解修剪模式——裁切動畫的開頭或結尾。
嵌入影片
請參閱 embedding-videos.md 了解關於嵌入影片的進階知識——修剪、音量、速度、循環、音高。
影片編輯
請參閱 video-editing.md 了解如何在 Remotion Studio 中建構可編輯的影片時間軸。
嵌入音訊
請參閱 audio.md 了解進階音訊功能,如修剪、音量、速度、音高。
轉場
請參閱 transitions.md 了解場景轉場模式。
視覺與像素特效
建立視覺特效時,優先順序為:1. 一般的 Remotion/HTML/CSS/SVG/濾鏡/混合/遮罩動畫,2. 透過 effects.md 列出的特效(包括在透過 <HtmlInCanvas> 渲染的 HTML 上),3. 當使用者要求可重複使用或專案特定的特效時,透過 effects.md 使用自訂 createEffect(),4. 僅在沒有合適特效時才使用自訂的 <HtmlInCanvas onPaint>(詳見 html-in-canvas.md)。
有關光漏疊加層,請參閱 light-leaks.md。文件:https://www.remotion.dev/docs/effects
可用特效:brightness()、contrast()、colorKey()、duotone()、grayscale()、hue()、invert()、saturation()、tint()、linearGradient()、linearGradientTint()、thermalVision()、blur()、linearProgressiveBlur()、radialProgressiveBlur()、zoomBlur()、dropShadow()、glow()、lightTrail()、evolve()、venetianBlinds()、mirror()、scale()、uvTranslate()、xyTranslate()、barrelDistortion()、chromaticAberration()、fisheye()、cornerPin()、wave()、burlap()、emboss()、dotGrid()、halftone()、noise()、noiseDisplacement()、paper()、roughenEdges()、pattern()、pixelate()、pixelDissolve()、scanlines()、speckle()、shine()、shrinkwrap()、vignette()、contourLines()、checkerboard()、halftoneLinearGradient()、gridlines()、whiteNoise()、tvSignalOff()、lines()、rings()、waves()、zigzag()、lightLeak()、starburst()。
3D 內容
請參閱 3d.md 了解在 Remotion 中使用 Three.js 和 React Three Fiber 的 3D 內容。
音效
當需要使用音效時,請載入 ./sfx.md 檔案以取得更多資訊。
音訊視覺化
當需要將音訊視覺化(頻譜長條圖、波形圖、低音反應特效)時,請載入 ./audio-visualization.md 檔案以取得更多資訊。
字幕
當處理字幕或標題時,請載入 Remotion 字幕 技能以取得更多資訊。
Google Fonts
這是 Remotion 中載入字型的推薦方式。請參閱 google-fonts.md 了解如何載入 Google Fonts。
本地字型
請參閱 local-fonts.md 了解如何載入本地字型。
GIF
請參閱 gifs.md 了解如何顯示與 Remotion 時間軸同步的 GIF。
進階圖片
請參閱 images.md 了解圖片大小與定位、動態圖片路徑以及取得圖片尺寸。
Lottie 動畫
請參閱 lottie.md 了解如何在 Remotion 中嵌入 Lottie 動畫。
進階時間控制
請參閱 timing.md 了解使用 interpolate 與貝茲曲線緩動以及彈簧的進階時間控制。
參數化影片
請參閱 parameters.md 了解如何透過新增 Zod schema 使組合參數化。
測量 DOM 節點
請參閱 measuring-dom-nodes.md 了解如何在 Remotion 中測量 DOM 元素尺寸。
測量文字
請參閱 measuring-text.md 了解如何測量文字尺寸、將文字適配容器以及檢查溢位。
使用 FFmpeg
對於某些影片操作,例如修剪影片或檢測靜音,應使用 FFmpeg。請載入 ./ffmpeg.md 檔案以取得更多資訊。
靜音檢測
當需要檢測並修剪影片或音訊檔案中的靜音片段時,請載入 ./silence-detection.md 檔案。
動態持續時間、尺寸與資料
請參閱 calculate-metadata.md 了解如何動態設定組合的持續時間、尺寸與屬性。
進階組合
請參閱 compositions.md 了解如何定義靜態圖、資料夾、預設屬性以及如何巢狀組合。
進階排序
請參閱 sequencing.md 了解更多排序模式——延遲、修剪、限制項目持續時間。
安裝模組
使用 npx remotion add 來以正確的版本新增套件:
npx remotion add @remotion/media
這適用於 @remotion/* 套件、mediabunny、@mediabunny/* 和 zod。
預覽標記
僅在使用者想看預覽時才這樣做。
npx remotion studio --no-open
這將啟動一個長時間執行的程序並印出預覽的伺服器 URL。 如果已經啟動,則會印出該 URL。
可選:單影格渲染檢查
你可以使用 CLI 渲染單個影格來進行佈局、顏色或時間的完整性檢查。 對於瑣碎的編輯、純重構,或者當你已經從 Studio 或之前的渲染獲得足夠信心時,可以跳過此步驟。
npx remotion still [composition-id] --scale=0.25 --frame=30
在 30 fps 時,--frame=30 表示一秒鐘的位置(--frame 是從 0 開始計算的)。