使用场景
每当你处理 Remotion 代码时,请使用此技能以获取领域特定的知识。
新项目搭建
当在一个空文件夹或没有现有 Remotion 项目的工作区中时,使用以下命令搭建一个新项目:
npx create-video@latest --yes --blank --no-tailwind my-video
将 my-video 替换为合适的项目名称。
设计视频
在设计视觉场景、布局、宣传片、动态图形或文本密集型视频之前,加载 rules/video-layout.md 以获取视频优先布局和文本大小调整指南。
使用 useCurrentFrame() 和 interpolate() 来对属性进行动画。除非明确需要基于物理的动效,否则优先使用 interpolate() 而不是 spring()。使用 Easing.bezier() 自定义时间轴,包括跳跃或超调的动效。
对于希望在 Remotion Studio 中可编辑的动画,将 interpolate() 调用内联放在 style 属性中,并使用单独的 CSS transform 属性(scale、translate、rotate),而不是组合一个 transform 字符串。
import { useCurrentFrame, Easing, interpolate, useVideoConfig } from "remotion";
export const FadeIn = () => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
});
return <div style={{ opacity }}>Hello World!</div>;
};
优先使用:
style={{
scale: interpolate(frame, [0, 100], [0, 1]),
translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}
而不是:
const scale = interpolate(frame, [0, 100], [0, 1]);
style={{
transform: `scale(${scale})`,
}}
禁止使用 CSS 过渡或动画——它们无法正确渲染。 禁止使用 Tailwind 动画类名——它们无法正确渲染。
将资源放在项目根目录的 public/ 文件夹中。
使用 staticFile() 引用 public/ 文件夹中的文件。
使用 <Img> 组件添加图片:
import { Img, staticFile } from "remotion";
export const MyComposition = () => {
return <Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />;
};
使用 @remotion/media 中的 <Video> 组件添加视频:
import { Video } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return <Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />;
};
使用 @remotion/media 中的 <Audio> 组件添加音频:
import { Audio } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return <Audio src={staticFile("audio.mp3")} />;
};
资源也可以作为远程 URL 引用:
import { Video } from "@remotion/media";
export const MyComposition = () => {
return <Video src="https://remotion.media/video.mp4" />
};
要延迟内容,将其包裹在 <Sequence> 中并使用 from。
要限制元素的持续时间,使用 <Sequence> 的 durationInFrames 属性。
默认情况下,<Sequence> 是一个绝对填充。对于内联内容,使用 layout="none"。
import { Sequence } from "remotion";
export const Title = () => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
});
return <div style={{ opacity }}>Title</div>;
};
export const Subtitle = () => {
return <div>Subtitle</div>;
};
const Main = () => {
const {fps} = useVideoConfig();
return (
<AbsoluteFill>
<Sequence>
<Background />
</Sequence>
<Sequence from={1 * fps} durationInFrames={2 * fps} layout="none">
<Title />
</Sequence>
<Sequence from={2 * fps} durationInFrames={2 * fps} layout="none">
<Subtitle />
</Sequence>
</AbsoluteFill>
);
}
视频的宽度、高度、帧率和持续时间在 src/Root.tsx 中定义:
import { Composition } from "remotion";
import { MyComposition } from "./MyComposition";
export const RemotionRoot = () => {
return (
<Composition
id="MyComposition"
component={MyComposition}
durationInFrames={100}
fps={30}
width={1080}
height={1080}
/>
);
};
元数据也可以动态计算:
import { Composition, CalculateMetadataFunction } from "remotion";
import { MyComposition, MyCompositionProps } from "./MyComposition";
const calculateMetadata: CalculateMetadataFunction<
MyCompositionProps
> = async ({ props, abortSignal }) => {
const data = await fetch(`https://api.example.com/video/${props.videoId}`, {
signal: abortSignal,
}).then((res) => res.json());
return {
durationInFrames: Math.ceil(data.duration * 30),
props: {
...props,
videoUrl: data.url,
},
width: 1080,
height: 1080,
};
};
export const RemotionRoot = () => {
return (
<Composition
id="MyComposition"
component={MyComposition}
fps={30}
width={1080}
height={1080}
defaultProps={{ videoId: "abc123" }}
calculateMetadata={calculateMetadata}
/>
);
};
开始预览
启动 Remotion Studio 以预览视频:
npx remotion studio
可选:单帧渲染检查
你可以使用 CLI 渲染一个单帧以快速检查布局、颜色或时间安排。 对于微不足道的编辑、纯重构或当你已经从 Studio 或之前的渲染中获得足够信心时,可以跳过此步骤。
npx remotion still [composition-id] --scale=0.25 --frame=30
在 30 fps 下,--frame=30 是 1 秒标记(--frame 从 0 开始)。
字幕
处理字幕或副标题时,加载 ./rules/subtitles.md 文件以获取更多信息。
使用 FFmpeg
对于某些视频操作,例如修剪视频或检测静音,应使用 FFmpeg。加载 ./rules/ffmpeg.md 文件以获取更多信息。
静音检测
当需要检测并修剪视频或音频文件中的静音片段时,加载 ./rules/silence-detection.md 文件。
音频可视化
当需要可视化音频(频谱条、波形、低音响应效果)时,加载 ./rules/audio-visualization.md 文件以获取更多信息。
音效
当需要使用音效时,加载 ./rules/sfx.md 文件以获取更多信息。
视觉和像素效果
当创建视觉效果时,优先考虑:1. 普通的 Remotion/HTML/CSS/SVG/滤镜/混合/遮罩动画,2. 通过 rules/effects.md 列出的效果(包括通过 <HtmlInCanvas> 渲染的 HTML),3. 当用户要求可重用/项目特定的效果时,通过 rules/effects.md 使用自定义 createEffect(),4. 仅当没有合适的效果时,使用自定义的 <HtmlInCanvas onPaint>(通过 rules/html-in-canvas.md)。
关于光泄漏叠加,请参阅 rules/light-leaks.md。文档:https://www.remotion.dev/docs/effects
可用效果:brightness()、contrast()、colorKey()、duotone()、grayscale()、hue()、invert()、saturation()、tint()、thermalVision()、blur()、linearProgressiveBlur()、zoomBlur()、dropShadow()、glow()、lightTrail()、evolve()、mirror()、scale()、uvTranslate()、xyTranslate()、barrelDistortion()、chromaticAberration()、fisheye()、cornerPin()、wave()、burlap()、emboss()、dotGrid()、halftone()、noise()、noiseDisplacement()、pattern()、pixelate()、pixelDissolve()、scanlines()、speckle()、shine()、shrinkwrap()、vignette()、contourLines()、checkerboard()、halftoneLinearGradient()、gridlines()、whiteNoise()、tvSignalOff()、lines()、rings()、waves()、zigzag()、lightLeak()、starburst()。
3D 内容
关于使用 Three.js 和 React Three Fiber 在 Remotion 中创建 3D 内容,请参阅 rules/3d.md。
高级音频
关于修剪、音量、速度、音高等高级音频功能,请参阅 rules/audio.md。
动态持续时间、尺寸和数据
关于动态设置构图持续时长、尺寸和属性的内容,请参阅 rules/calculate-metadata.md。
高级构图
关于如何定义静态图像、文件夹、默认属性以及如何嵌套构图,请参阅 rules/compositions.md。
Google Fonts
这是在 Remotion 中加载字体的推荐方式。关于如何加载 Google Fonts,请参阅 rules/google-fonts.md。
本地字体
关于如何加载本地字体,请参阅 rules/local-fonts.md。
获取音频持续时间
关于使用 Mediabunny 获取音频文件的持续时间(以秒为单位),请参阅 rules/get-audio-duration.md。
获取视频尺寸
关于使用 Mediabunny 获取视频文件的宽度和高度,请参阅 rules/get-video-dimensions.md。
获取视频持续时间
关于使用 Mediabunny 获取视频文件的持续时间(以秒为单位),请参阅 rules/get-video-duration.md。
GIF
关于如何显示与 Remotion 时间轴同步的 GIF,请参阅 rules/gifs.md。
高级图像
关于调整图像大小和位置、动态图像路径以及获取图像尺寸,请参阅 rules/images.md。
Lottie 动画
关于在 Remotion 中嵌入 Lottie 动画,请参阅 rules/lottie.md。
测量 DOM 节点
关于在 Remotion 中测量 DOM 元素的尺寸,请参阅 rules/measuring-dom-nodes.md。
测量文本
关于测量文本尺寸、使文本适合容器以及检查溢出,请参阅 rules/measuring-text.md。
高级序列
关于更多序列模式——延迟、修剪、限制项目持续时间,请参阅 rules/sequencing.md。
TailwindCSS
关于在 Remotion 中使用 TailwindCSS,请参阅 rules/tailwind.md。
文本动画
关于排版和文本动画模式,请参阅 rules/text-animations.md。
高级时间轴
关于使用 interpolate 和贝塞尔缓动以及弹簧的高级时间轴,请参阅 rules/timing.md。
过渡
关于场景过渡模式,请参阅 rules/transitions.md。
透明视频
关于输出带透明度的视频,请参阅 rules/transparent-videos.md。
修剪
关于修剪模式——剪切动画的开头或结尾,请参阅 rules/trimming.md。
高级视频
关于嵌入视频的高级知识——修剪、音量、速度、循环、音调,请参阅 rules/videos.md。
参数化视频
关于通过添加 Zod 模式使构图可参数化,请参阅 rules/parameters.md。
地图
对于简单的、飞行路线较少的地图,考虑使用静态地图图像。 对于具有动画路线或飞行路线的复杂地图,请加载地图规则:rules/maplibre.md
画外音
关于使用 ElevenLabs TTS 向 Remotion 构图添加 AI 生成的画外音,请参阅 rules/voiceover.md。