Dies ist eine Anleitung zum Schreiben von Remotion React Markup. Wenn dies nicht relevant ist, laden Sie stattdessen Remotion Best Practices.
Allgemeine Regeln
Animieren Sie Eigenschaften mit useCurrentFrame() und interpolate().
Verwenden Sie interpolate() anstelle von spring().
Nutzen Sie Easing.bezier(), um das Timing anzupassen, einschließlich hüpfender oder überschießender Bewegungen.
Verwenden Sie Easing.spring(), wenn Sie Feder-Animationen wünschen.
HTML-Elemente, die im Studio interaktiv gemacht werden sollen, sollten Interactive verwenden: <div> -> <Interactive.Div>.
Setzen Sie einen beschreibenden name-Prop 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>
);
};
Behalten Sie den interpolate()-Aufruf inline im style-Prop bei.
Bevorzugen Sie die CSS-Eigenschaften scale, translate, rotate gegenüber transform.
// 👍 Inline bearbeitbare Keyframes und Transform-Kurzformen
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-Übergänge oder -Animationen sind VERBOTEN – sie werden nicht korrekt gerendert. Tailwind-Animation-Klassennamen sind VERBOTEN – sie werden nicht korrekt gerendert.
Platzieren Sie Assets im Ordner public/ im Stammverzeichnis Ihres Projekts.
Verwenden Sie staticFile(), um Dateien aus dem public/-Ordner zu referenzieren.
Fügen Sie Video und Audio mit @remotion/media hinzu.
Fügen Sie Bilder mit der <Img>-Komponente hinzu.
Verwenden Sie staticFile() für Dateien in public/ oder geben Sie direkt eine Remote-URL an:
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, umhüllen Sie sie mit <Sequence> und verwenden Sie from.
Um die Dauer eines Elements zu begrenzen, verwenden Sie durationInFrames von <Sequence>.
<Sequence> ist standardmäßig eine absolute Füllung, die die Szene bedeckt.
Für Inline-Inhalte verwenden Sie 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 und Anmerkungen
Siehe text-highlights.md für Text-Highlights (Hervorhebungsmarkierungen), Kreise, Unterstreichungen, Durchstreichungen, durchgestrichenen Text, Boxen und Klammern.
Voiceover
Siehe voiceover.md zum Hinzufügen von KI-generiertem Voiceover zu Remotion-Kompositionen mit ElevenLabs TTS.
Trimmung
Siehe trimming.md für Trimm-Muster – das Abschneiden des Anfangs oder Endes von Animationen.
Einbetten von Videos
Siehe embedding-videos.md für fortgeschrittenes Wissen zum Einbetten von Videos – Trimmung, Lautstärke, Geschwindigkeit, Schleifen, Tonhöhe.
Videobearbeitung
Siehe video-editing.md zum Strukturieren bearbeitbarer Video-Zeitachsen im Remotion Studio.
Einbetten von Audio
Siehe audio.md für erweiterte Audiofunktionen wie Trimmung, Lautstärke, Geschwindigkeit, Tonhöhe.
Übergänge
Siehe transitions.md für Szenenübergangsmuster.
Visuelle und Pixeleffekte
Bevorzugen Sie beim Erstellen eines visuellen Effekts: 1. normale Remotion/HTML/CSS/SVG/Filter/Blend/Mask-Animation, 2. einen aufgelisteten Effekt über effects.md, einschließlich auf HTML, das durch <HtmlInCanvas> gerendert wird, 3. einen benutzerdefinierten createEffect() über effects.md, wenn der Benutzer nach einem wiederverwendbaren/projektspezifischen Effekt fragt, 4. benutzerdefiniertes <HtmlInCanvas onPaint> über html-in-canvas.md nur, wenn kein Effekt passt.
Für Light-Leak-Overlays siehe light-leaks.md. Doku: 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 Sie Soundeffekte benötigen, laden Sie die Datei ./sfx.md für weitere Informationen.
Audio-Visualisierung
Wenn Sie Audio visualisieren müssen (Spektrum-Balken, Wellenformen, bassreaktive Effekte), laden Sie die Datei ./audio-visualization.md für weitere Informationen.
Untertitel
Wenn es um Untertitel oder Untertitel (Captions) geht, laden Sie das Skill Remotion Captions für weitere Informationen.
Google Fonts
Dies ist die empfohlene Methode, um Schriftarten in Remotion zu laden. Siehe google-fonts.md zum Laden von Google Fonts.
Lokale Schriftarten
Siehe local-fonts.md zum Laden lokaler Schriftarten.
GIFs
Siehe gifs.md zum Anzeigen von GIFs, die mit der Zeitachse von Remotion synchronisiert sind.
Fortgeschrittene 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.
Fortgeschrittenes Timing
Siehe timing.md für fortgeschrittenes 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 der Abmessungen von DOM-Elementen 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 Video-Operationen, wie das Trimmen von Videos oder das Erkennen von Stille, sollte FFmpeg verwendet werden. Laden Sie die Datei ./ffmpeg.md für weitere Informationen.
Stille-Erkennung
Wenn Sie stille Segmente aus Video- oder Audiodateien erkennen und trimmen müssen, laden Sie die Datei ./silence-detection.md.
Dynamische Dauer, Abmessungen und Daten
Siehe calculate-metadata.md zum dynamischen Festlegen von Kompositionsdauer, -abmessungen und -Props.
Fortgeschrittene Kompositionen
Siehe compositions.md zur Definition von Standbildern, Ordnern, Standard-Props und zur Verschachtelung von Kompositionen.
Fortgeschrittene Sequenzierung
Siehe sequencing.md für weitere Sequenzierungsmuster – Verzögerung, Trimmung, Begrenzung der Dauer von Elementen.
Module installieren
Verwenden Sie 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ühren Sie dies nur aus, wenn Sie glauben, 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: Ein-Frame-Render-Prüfung
Sie können ein einzelnes Frame mit der CLI rendern, um Layout, Farben oder Timing zu überprüfen. Überspringen Sie dies bei trivialen Bearbeitungen, reinen Refactorings oder wenn Sie bereits genügend Vertrauen aus dem Studio oder vorherigen Render-Durchläufen haben.
npx remotion still [composition-id] --scale=0.25 --frame=30
Bei 30 fps ist --frame=30 die Ein-Sekunden-Marke (--frame ist nullbasiert).