Communitygithub.com

IGNOVA-SYSTEMS-INTEGRATION/KONTRX

使用 Remotion(React/TypeScript 视频代码库,输出 MP4)以编程方式构建视频的最佳实践和领域知识。在编写或编辑 Remotion 代码时使用——包括搭建视频项目、使用 interpolate/spring 基于 useCurrentFrame() 制作动画、场景与转场编排、字幕、音频、GIF/Lottie/3D、图表、视觉效果、通过 calculateMetadata 实现动态时长,以及渲染。在调用 Remotion API 前请先查阅此技能,因为其组件和属性会不断演进(例如 @remotion/media)。

KONTRX 是什么?

此技能为使用 Remotion 进行程序化视频制作提供了全面的领域知识和最佳实践。它涵盖了从项目初始化(使用 `npx create-video`)到高级功能的完整工作流,包括动画(推荐 `interpolate` 而非 `spring`,除非需要物理运动)、场景编排(`Sequence`)、资源管理(`staticFile`、`<Img>`、`<Video>`、`<Audio>`)和动态元数据(`calculateMetadata`)。该技能明确禁止 CSS 过渡/动画和 Tailwind 动画类名,因为这些在 Remotion 中无法正确渲染。此外,它还提供了详细的指导,涉及字幕、FFmpeg 集成、音频可视化、音效、3D 内容(React Three Fiber)、视觉效果(超过 50 种内置效果)、动态时长和参数化视频。该技能适用于 Claude Code、Cursor 等 AI agent 平台,作为开发 Remotion 视频项目时的权威参考,确保代码正确、高效并遵循最佳实践。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/IGNOVA-SYSTEMS-INTEGRATION/KONTRX/tree/HEAD/AGENT/skills/remotion

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

预览

来自技能 README

文档

使用时机

当处理 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 prop 中,并使用单独的 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>
  );
}

视频的宽度、高度、fps 和持续时间在 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(), 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(), pattern(), pixelate(), pixelDissolve(), scanlines(), speckle(), shine(), shrinkwrap(), vignette(), contourLines(), checkerboard(), halftoneLinearGradient(), gridlines(), whiteNoise(), tvSignalOff(), lines(), rings(), waves(), zigzag(), lightLeak(), starburst()。

3D 内容

关于在 Remotion 中使用 Three.js 和 React Three Fiber 创建 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。

相关技能