Dies ist eine Anleitung zum Schreiben von Remotion React Markup. Wenn dies nicht relevant ist, lade stattdessen Remotion Best Practices.
Allgemeine Regeln
Animiere Eigenschaften mit useCurrentFrame() und interpolate().
Verwende interpolate() anstelle von spring().
Nutze Easing.bezier(), um das Timing anzupassen, einschließlich hüpfender oder überschießender Bewegungen.
Verwende Easing.spring(), wenn du Federanimationen möchtest.
HTML-Elemente, die im Studio interaktiv gemacht werden sollen, sollten Interactive verwenden: <div> -> <Interactive.Div>.
Setze eine beschreibende name-Eigenschaft wie name="Hero title" für Interactive, Solid, Sequence.
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>
);
};
Halte den interpolate()-Aufruf inline in der style-Eigenschaft.
Bevorzuge die CSS-Eigenschaften scale, translate, rotate gegenüber transform.
// 👍 Inline bearbeitbare Keyframes und Transform-Shorthands
style={{
scale: interpolate(frame, [0, 100], [0, 1]),
translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}
// 👎 Versteckte Werte und Transform-Strings werden im Studio schwerer zu bearbeiten
const scale = interpolate(frame, [0, 100], [0, 1]);
style={{
transform: `scale(${scale})`,
}}
CSS-Transitionen oder -Animationen sind VERBOTEN – sie werden nicht korrekt gerendert. Tailwind-Animations-Klassennamen sind VERBOTEN – sie werden nicht korrekt gerendert.
Lege Assets im Ordner public/ im Projektstammverzeichnis ab.
Verwende staticFile(), um Dateien aus dem Ordner public/ zu referenzieren.
Füge Video und Audio mit @remotion/media hinzu.
Füge Bilder mit der <Img>-Komponente hinzu.
Verwende staticFile() für Dateien in public/ oder übergib direkt eine Remote-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" />
</>
);
};
Um Inhalte zu verzögern, umschließe sie mit <Sequence> und verwende from.
Um die Dauer eines Elements zu begrenzen, verwende durationInFrames von <Sequence>.
Standardmäßig füllt <Sequence> absolut den gesamten Bildschirm aus.
Für Inline-Inhalte verwende 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>;
};
Karten
Siehe map.md für die Auswahl zwischen einfachen statischen Karten, Mapbox-Karten und MapLibre-Karten.
Sprachausgabe
Siehe voiceover.md zum Hinzufügen von KI-generierter Sprachausgabe zu Remotion-Kompositionen mit ElevenLabs TTS.
Trimmen
Siehe trimming.md für Muster zum Trimmen – Schneiden des Anfangs oder Endes von Animationen.
Videos einbetten
Siehe embedding-videos.md für fortgeschrittenes Wissen zum Einbetten von Videos – Trimmen, Lautstärke, Geschwindigkeit, Looping, Tonhöhe.
Audio einbetten
Siehe audio.md für fortgeschrittene Audiofunktionen wie Trimmen, Lautstärke, Geschwindigkeit, Tonhöhe.
Übergänge
Siehe transitions.md für Szenenübergangsmuster.
Visuelle und Pixeleffekte
Beim Erstellen eines visuellen Effekts bevorzuge: 1. normale Remotion/HTML/CSS/SVG/Filter/Blend/Mask-Animation, 2. einen aufgelisteten Effekt über effects.md, auch auf HTML, das über <HtmlInCanvas> gerendert wird, 3. ein benutzerdefiniertes createEffect() über effects.md, wenn der Benutzer nach einem wiederverwendbaren/projektspezifischen Effekt fragt, 4. ein benutzerdefiniertes <HtmlInCanvas onPaint> über html-in-canvas.md nur, wenn kein Effekt passt.
Für Überlagerungen von Lichtlecks siehe light-leaks.md. Docs: https://www.remotion.dev/docs/effects
Verfügbare Effekte: 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-Inhalte
Siehe 3d.md für 3D-Inhalte in Remotion mit Three.js und React Three Fiber.
Soundeffekte
Wenn Soundeffekte benötigt werden, lade die Datei ./sfx.md für weitere Informationen.
Audiovisualisierung
Wenn Audio visualisiert werden soll (Spektrumbalken, Wellenformen, bassreaktive Effekte), lade die Datei ./audio-visualization.md für weitere Informationen.
Untertitel
Wenn es um Untertitel oder Beschriftungen geht, lade die Skill Remotion Captions für weitere Informationen.
Google Fonts
Ist die empfohlene Methode zum Laden von Schriftarten in Remotion. Siehe google-fonts.md für Informationen zum Laden von Google Fonts.
Lokale Schriftarten
Siehe local-fonts.md für Informationen zum Laden lokaler Schriftarten.
GIFs
Siehe gifs.md für Informationen zur Anzeige von GIFs synchron zur Remotion-Zeitleiste.
Erweiterte Bilder
Siehe images.md für Größenanpassung und Positionierung von Bildern, dynamische Bildpfade und das Ermitteln von Bildabmessungen.
Lottie-Animationen
Siehe lottie.md zum Einbetten von Lottie-Animationen in Remotion.
Erweitertes Timing
Siehe timing.md für erweitertes Timing mit interpolate und Bézier-Easing sowie Federn.
Parametrisierte Videos
Siehe parameters.md zum Parametrisieren einer Komposition durch Hinzufügen eines Zod-Schemas.
Messen von DOM-Knoten
Siehe measuring-dom-nodes.md zum Messen von DOM-Elementabmessungen in Remotion.
Messen von Text
Siehe measuring-text.md zum Messen von Textabmessungen, Anpassen von Text an Container und Überprüfen von Überlauf.
Verwendung von FFmpeg
Für einige Videooperationen, wie das Trimmen von Videos oder die Erkennung von Stille, sollte FFmpeg verwendet werden. Lade die Datei ./ffmpeg.md für weitere Informationen.
Stille-Erkennung
Wenn stille Segmente aus Video- oder Audiodateien erkannt und getrimmt werden müssen, lade die Datei ./silence-detection.md.
Dynamische Dauer, Abmessungen und Daten
Siehe calculate-metadata.md zum dynamischen Festlegen von Kompositionsdauer, Abmessungen und Eigenschaften.
Erweiterte Kompositionen
Siehe compositions.md für die Definition von Standbildern, Ordnern, Standardeigenschaften und zum Verschachteln von Kompositionen.
Erweiterte Sequenzierung
Siehe sequencing.md für weitere Sequenzierungsmuster – Verzögerung, Trimmen, Begrenzung der Dauer von Elementen.
Module installieren
Verwende npx remotion add, um neue Pakete mit der richtigen Version hinzuzufügen:
npx remotion add @remotion/media
Dies gilt für @remotion/*-Pakete, mediabunny, @mediabunny/* und zod.
Vorschau des Markups
Führe dies nur aus, wenn du denkst, dass der Benutzer die Vorschau sehen möchte.
npx remotion studio --no-open
Dies startet einen langlebigen Prozess und gibt die Server-URL für die Vorschau aus. Wenn bereits gestartet, wird die URL ausgegeben.
Optional: Einzelbild-Render-Check
Du kannst ein einzelnes Bild mit der CLI rendern, um Layout, Farben oder Timing zu überprüfen. Überspringe dies für triviale Änderungen, reine Refactorings oder wenn du bereits genug Vertrauen aus Studio oder vorherigen Renderings hast.
npx remotion still [composition-id] --scale=0.25 --frame=30
Bei 30 fps ist --frame=30 die Ein-Sekunden-Marke (--frame ist nullbasiert).