Remotion
Remotion verwandelt React-Komponenten in Videos. Sie schreiben JSX, Remotion ruft Ihre Komponente einmal pro Frame mit einer festen fps auf, und die resultierenden Frames werden zu einem MP4 (oder einem anderen Format) zusammengesetzt.
Gedankliches Kernmodell
Remotion gibt Ihnen eine Frames-Nummer und eine leere Leinwand. Ihre React-Komponente entscheidet, was in diesem Frame gerendert wird.
Es gibt keine Animations-Timeline im imperativen Sinne. Zeit ist eine Zahl (frame), und Ihre Komponente ist eine reine Funktion dieser Zahl plus Props. Deshalb müssen Animationen mit useCurrentFrame() gesteuert werden – CSS-Übergänge und setTimeout sind während des Renderns nicht deterministisch und führen zu Flackern oder Synchronisationsfehlern.
Wann diese Fertigkeit verwendet werden sollte
- Der Benutzer hat ein Remotion-Projekt (
remotion.config.tsoder@remotion/*in package.json) und möchte eine Komposition erstellen, ändern oder debuggen - Der Benutzer sagt „Lass uns ein Video mit Remotion/mit Code/programmatisch erstellen“
- Der Benutzer fügt einen Remotion-Fehler ein oder fragt nach
interpolate,spring,Sequence,useCurrentFrame,Compositionusw. - Der Benutzer möchte ein bestehendes Remotion-Projekt rendern oder Lambda-Rendering einrichten
Wann NICHT zu verwenden
- Video mit KI-Modellen erstellen (Veo, Sora, Runway, Kling, HeyGen) → verwenden Sie die video-Fertigkeit
- Bestehende Videodateien bearbeiten (schneiden/trimmen/konkatenieren) → ffmpeg, nicht Remotion
- Livestreaming → Remotion ist reines Offline-Rendering
Arbeitsablauf
-
Projekt erkennen oder erstellen.
- Neues Projekt:
npx create-video@latest(interaktiv – wählt eine Vorlage wie Hello World, Blank, JavaScript, TikTok usw.) - Bestehend: Prüfen auf
remotion.config.ts,src/Root.tsxund@remotion/cliinpackage.json. Notieren Sie die Remotion-Hauptversion – die APIs entwickeln sich weiter, und die korrekte Dokumentations-URL isthttps://www.remotion.dev/docs(aktuellste) oder versionierte Seiten.
- Neues Projekt:
-
Komposition lokalisieren oder erstellen. Kompositionen werden in
src/Root.tsxüber<Composition id="..." component={...} durationInFrames={...} fps={30} width={1920} height={1080} defaultProps={{...}} />registriert. Dieidist das, was die CLI namentlich rendert. -
Komponente mit
useCurrentFrame+useVideoConfigfür Zeit und Metadaten erstellen. Layout mit<AbsoluteFill>zusammensetzen, Zeitabschnitte mit<Sequence>. -
Vorschau im Studio:
npx remotion studio(automatisches Neuladen). Versuchen Sie nicht, Frames isoliert zu „testen“ – öffnen Sie das Studio. -
Rendern:
npx remotion render <CompositionId> [output.mp4]. Standard-Codec ist H.264/MP4. Siehe references/rendering.md für Flags und programmatische API.
Kurze API-Referenz
In den verlinkten Dateien finden Sie Details – laden Sie diese nur, wenn eine Aufgabe sie benötigt.
| Thema | Datei |
|---|---|
| Composition, Hooks, Sequence, AbsoluteFill, Layout | references/core-concepts.md |
interpolate, spring, Easing, Staffelung, gängige Animationsmuster | references/animation.md |
Rendering: CLI-Flags, @remotion/renderer, Lambda, Codecs, Props | references/rendering.md |
Audio/Video/Bilder: <Audio>, <Video>, <Img>, <OffthreadVideo>, Untertitel | references/media.md |
Projekteinrichtung, Dateikonventionen, remotion.config.ts | references/project-setup.md |
| Gängige Muster: Schreibanimationen, Lower Thirds, datengetrieben, Parallaxe | references/patterns.md |
Harte Regeln
- Mit
useCurrentFrame()animieren. NiemalssetTimeout,requestAnimationFrameoder CSStransition. Diese flackern beim Rendern, da jeder Frame unabhängig in einem Headless-Browser gerendert wird. durationInFramesist erforderlich und muss eine ganze Zahl sein. Gesamtsekunden =durationInFrames / fps.- Komponenten rein halten. Keine Side-Effects auf oberster Ebene, kein
Math.random()ohne deterministischen Seed – derselbe Frame muss immer dieselben Pixel erzeugen. - Nicht im Render-Fetch abrufen. Verwenden Sie
delayRender()/continueRender(), um die Frame-Bereitschaft zu blockieren, während Daten geladen werden, oder rufen Sie vorab ab und übergeben Sie sie per Props. - Wenn möglich
<OffthreadVideo>anstelle von<Video>verwenden für nicht blockierende Video-Lesevorgänge während des Renderns (schneller, weniger Speicher). - Dynamische Daten über
--props(CLI) oderinputProps(Studio/programmatisch) übergeben, nicht durch Bearbeiten von Dateien.
Häufige Fehler
| Fehler / Symptom | Ursache | Behebung |
|---|---|---|
| Flackern / nicht übereinstimmende Bewegung in MP4 vs. Studio-Vorschau | CSS-Übergänge oder nicht frame-gesteuerte Animation verwendet | Ersetzen durch interpolate(frame, ...) oder spring({ frame, fps }) |
| „Komposition nicht gefunden“ | Tippfehler in ID oder fehlende <Composition>-Registrierung | src/Root.tsx überprüfen |
| Rendern hängt | Ausstehendes delayRender() hat nie continueRender() aufgerufen | Nicht aufgelöstes Promise finden; try/finally hinzufügen |
| Speichermangel bei langen Videos | <Video> hält Frames im Speicher | Auf <OffthreadVideo> umstellen |
| Audio nicht synchron | Audio-Datei-FPS stimmen nicht überein oder Start bei falschem Frame | <Audio> in <Sequence from={...}> einwickeln |
Überprüfung
Nach Änderungen immer:
npx remotion studioausführen und die Zeitleiste durchgehen, um zu bestätigen, dass die Änderung an mehreren Frames korrekt aussieht (Anfang, Mitte, Ende)- Für programmatische Änderungen ein kurzes Testsegment rendern:
npx remotion render <id> out.mp4 --frames=0-60 - Typprüfung:
npx tsc --noEmit, falls das Projekt TypeScript verwendet
Behaupten Sie keinen Erfolg ohne einen dieser Schritte. Code, der kompiliert, ist nicht dasselbe wie ein Video, das richtig aussieht.