REMOTION MOTION DESIGN — Implementierungsfähigkeit
1. Überprüfung vor dem Codieren
- Lies
CLAUDE.md,MASTER_PROMPT.mdund die Architekturdokumente. - Überprüfe die tatsächlichen Remotion/React/TypeScript-Versionen und den Paketmanager.
- Finde den bestehenden Einstiegspunkt und das Kompositionsregister.
- Folge den Konventionen des Repositorys; wechsle Abhängigkeiten nicht ohne Grund aus.
- Verwende die Ausgabe von
beyond-video, das Skript, das Storyboard und die Style-Bibel als Produktionsspezifikation. - Überprüfe die von dir verwendeten APIs anhand der Remotion-Quelle der installierten Version
(z. B.
packages/core/srcin einem Referenz-Klon), bevor du dich auf das Gedächtnis verlässt.
2. Kompositionsprofil
Standardwerte:
- width: 1080
- height: 1920
- fps: 60
- aspect: 9:16
- duration: positive ganze Zahl in Frames
Jede Komposition benötigt eine eindeutige ID und explizite Metadaten. Speichere keine unterschiedlichen FPS-Werte in mehreren Layern ohne Grund.
<Composition> akzeptiert id, fps, width, height, durationInFrames,
defaultProps und optional calculateMetadata (dynamische Dauer/Metadaten von Props) und schema. durationInFrames muss positiv sein.
3. Timeline-Engineering
- Halte Dauern und Startframes in zentralisierten Daten/Konfigurationen.
- Verwende eine Frame-Intervall-Konvention;
[start, end)wird empfohlen. - Die
durationInFrameseiner Szene muss positiv sein. - Stelle sicher, dass die Gesamtdauer der Komposition jede Szene sowie den Abspann/Ende umfasst.
- Überprüfe Überschneidungen und Lücken; Überschneidungen sind nur erlaubt, wenn sie für einen Übergang/eine Compositing beabsichtigt sind.
- Verlasse dich für die endgültige Framegrenze nicht auf Fließkommazahlen.
4. Deterministische Animation — Zeit/Frame-APIs (Remotion 4.x)
Zeitquellen:
useCurrentFrame()— der aktuelle Frame, 0-basiert. Nur innerhalb einer Kompositionskomponente verwendbar; außerhalb einer Komposition wird ein Fehler geworfen.useVideoConfig()— gibt{width, height, fps, durationInFrames, id, defaultProps, defaultVideoImageFormat, ...}zurück; wirft einen Fehler außerhalb einer Komposition.
Interpolation und Spring:
interpolate(input, inputRange, outputRange, options?)— Überladungen für Zahl, String, Boolean und Array-Ausgabe. Optionen:easing,extrapolateLeft/extrapolateRight('extend' | 'identity' | 'clamp' | 'wrap'),output,outputType,posterize. Verwende Clamp-Extrapolation, wenn Bewegung nicht über den Bereich hinauslaufen darf.spring({frame, fps, config?, from=0, to=1, durationInFrames?, durationRestThreshold?, delay=0, reverse=false}).SpringConfig:damping(Standard 10),mass(1),stiffness(100),overshootClamping(false).damping <= 0lässt die Animation nie zur Ruhe kommen (Endlosschleifen-Fehler).measureSpring({fps, config?, threshold=0.005})— Anzahl der Frames, bis die Feder zur Ruhe kommt;threshold=0ergibtInfinity.
Regeln:
- Bewegung muss eine Funktion von Frame und Props sein.
- Verwende gesetzte Startwerte für Partikel/Rauschen/Zufallswerte.
- Vermeide
setInterval,setTimeout,requestAnimationFrame,Date.now()und selbstlaufende CSS-Keyframes als Hauptquelle für Videobewegung. - Lade keine Netzwerkdaten während die Komposition rendert.
- Binde kein Audio/Video von instabilen URLs oder URLs, die eine Anmeldung erfordern, ein.
delayRender(label?, options?)hält den Renderprozess an, biscontinueRender(handle)aufgerufen wird (z. B. asynchrone Assets); sein Timeout wird mit dem CLI--timeoutgesetzt.
5. Sequence, Series und lokale vs. globale Frames
Dies ist die Regel, die am häufigsten falsch verstanden wird — es gab tatsächlich einen Fehler, weil eine
Komponente den globalen Frame innerhalb einer Series.Sequence berechnet hat:
- Innerhalb einer
<Sequence>gibtuseCurrentFrame()den Frame RELATIV zum Start der Sequence zurück:(frame - (cumulatedFrom + relativeFrom)) * playbackRate. Komponenten innerhalb einer Sequence sehen NICHT den globalen Frame. <Sequence>-Props:from?,name?,durationInFrames?(muss positiv sein; erforderlich bei Verwendung vonloop),layout('absolute-fill'|'none'),premountFor,loopund Crop-Props (nur mitlayout="absolute-fill").<Series.Sequence>darf NUR innerhalb von<Series>verwendet werden; eineSeries.Sequenceaußerhalb von<Series>wirft „This component must be inside a<Series />component."- Zwei gültige Routing-Muster — wähle eines aus und bleibe konsistent:
- Globaler Frame-Router (im Videoprojekt verwendet): Eine Router-Komponente
verwendet den globalen
useCurrentFrame()und wählt den Beat anhand seines[start, end)-Bereichs aus; Beat-Komponenten berechnen aus dem globalen Frame. - Series: Jede
Series.Sequenceenthält einen Beat; Beat-Komponenten berechnen aus dem lokalen Frame (0 am Start der Sequence).
- Globaler Frame-Router (im Videoprojekt verwendet): Eine Router-Komponente
verwendet den globalen
- Mische beide Muster nicht ohne expliziten Grund in einer Komposition.
6. Szenen-/Komponentenstruktur
- Eine Szene hat eine narrative/visuelle Verantwortung.
- Szenen-Props sind in TypeScript definiert.
- Wiederverwendbare Komponenten lösen eine klare visuelle Aufgabe.
- Vermeide eine einzige Datei, die das gesamte Video enthält.
- Trenne Inhaltskonfiguration, Renderer, Style-Tokens und Asset-Referenzen.
- Füge entworfene Fallbacks für optionale Assets hinzu; verstecke niemals ein fehlendes kritisches Asset.
7. Medienkomponenten und Assets
<Img src>— ein Bild, das ohneonErrornicht geladen werden kann, bricht den Render ab (cancelRender). Gib immeronErrorfür kritische Assets an oder stelle sicher, dass das Asset vor dem Rendern existiert.staticFile(path)— bildet eine Datei inpublic/ab; verwende es für jedes lokale Asset (Bilder, Audio, Video).<Audio>— siehesound-designfür die Zuordnung einer Cue-Sheet zu Props (trimBefore/After— älterer AliasstartFrom/endAt—volume,playbackRate). Die Position eines Cues auf der Timeline wird durch<Sequence from>gesetzt; die Trim-Props schneiden nur den Teil der Datei, der abgespielt wird.<Audio>hat keinmuted-Prop; Stummschaltung ist ein CLI-Flag (--muted).<Video>/<OffthreadVideo>und<Still>folgen denselben Frame-Regeln; die Mediendauer muss anhand von Frames geplant werden, nicht anhand von Dateimetadaten.
8. 2D-Bewegung
Verwende SVG/Formen/CSS/Raster nach Bedarf. Achte auf Ankerpunkte, Transformationsursprünge, Anti-Aliasing, Schichtung, Clipping und den sicheren Bereich. Jede Transformation muss frame-gesteuert sein.
9. Pixel- und Strichmännchen-Unterstützung
Pixel-Art:
- Sperre die logische Leinwand und den Pixelmaßstab;
- verwende Nearest-Neighbor beim Skalieren von Sprites;
- raste Positionen bei Bedarf auf das Raster ein;
- sperre die Palette und die Sprite-Abmessungen;
- vermeide Unschärfe und Subpixel-Flimmern.
Strichmännchen:
- Halte Proportionen und Drehpunkte konsistent;
- verwende eine Pose/Rig-Bibliothek, wenn der Projektumfang dies rechtfertigt;
- animiere Silhouette und Geste, sodass sie lesbar sind;
- synchronisiere Ausdrücke/Posen mit Story-Beats.
Für Gehzyklen, Durchschwingen und Ruhebewegungen siehe character-animation.
10. 3D-Bewegung
- Füge 3D nur hinzu, wenn es einen kreativen Mehrwert bringt.
- Überprüfe die Versionen von
three,@react-three/fiber,@remotion/threeund deren Dokumentation. - Für die Remotion ThreeCanvas-Integration folge dem frame-gesteuerten Ansatz der installierten API-Version; gehe nicht davon aus, dass Echtzeit-R3F-Muster automatisch deterministisch sind.
- Steuere Kamera, Transformationen, Materialien, Beleuchtung und Partikel über den Frame.
- Berücksichtige Renderer-/Headless-Kompatibilität, Texturgröße, Geometrie und Rechenaufwand.
- Trenne die 3D-Ebene von 2D-Typografie/Overlays, wenn dies die Lesbarkeit und Wartbarkeit verbessert.
- Für die detaillierte Regie von 3D-Szenen siehe
3d-scene-director.
11. Typografie und Übergänge
- Priorisiere Hierarchie und Lesbarkeit.
- Decke niemals wichtige Kopie mit einem Übergang ab.
- Jeder Übergang verbindet zwei Beats; füge keine Effekte ohne Funktion hinzu.
- Halte Bewegungskurven und -intensität durch die Style-Bibel hindurch konsistent.
- Passe die Textdauer an die Leseanforderungen an.
12. Abschluss-Implementierung
Implementiere das Abschluss-Logo + CTA gemäß dem beyond-video-Arbeitsblatt. Das Logo muss von einem offiziellen Asset oder einem genehmigten Platzhalter stammen. Text, Timing, Motiv und Compositing müssen sich wie für das jeweilige Video maßgeschneidert anfühlen.
13. Qualitätssicherung vor der Übergabe
Überprüfe Kompositions-ID, Metadaten, Frame-Bereiche, Importe, Typen, statische Assets, Schriftarten, Stilkonsistenz, sicheren Bereich, Abschluss und Asset-Lizenzen. Führe die verfügbaren Lint/Typprüfung/Tests aus. Rendere kein MP4. Committe/Pushe nicht.
Ausgabeformat
- Kompositionsregister: ID, 1080×1920, 60 FPS, durationInFrames, Szenenliste + Frame-Bereiche.
- Verwendete APIs: API-Name + relevante Signatur + wo sie überprüft wurde (installierte Remotion-Version).
- Frame-Routing-Muster: global oder Series — eine Wahl, konsistent über die Komposition hinweg.
- Asset-Register: Datei,
staticFile, Fallback/onErrorpro kritischem Asset. - Qualitätssicherungs-Checkliste + Typprüfung/Lint-Ergebnisse.
Mini-Beispiel
Globaler Frame-Router (Videoprojekt-Muster):
const frame = useCurrentFrame();
const beat = BEATS.find((b) => frame >= b.start && frame < b.end);
return (
<AbsoluteFill>
{beat?.id === 'S01-B01' && <Hook />}
{beat?.id === 'S01-B02' && <Problem />}
</AbsoluteFill>
);
Spring mit gemessener Dauer:
const settle = measureSpring({fps, config: {damping: 12}});
const progress = spring({frame, fps, config: {damping: 12}});
Fehlermodi
- Eine Komponente innerhalb von
Series.Sequenceberechnet den globalen Frame → falscher Beat, Szenen erscheinen zur falschen Zeit. Behebung: Berechne aus dem lokalen Frame oder wechsle zu einem globalen Frame-Router. Series.Sequenceohne<Series>verwendet → wirft einen Fehler beim Rendern. Wickle es in<Series>ein oder verwende<Sequence>direkt (nichtSeries.Sequence).springmitdamping <= 0→ die Animation kommt nie zur Ruhe. Haltedamping > 0.- Fehlendes Bild ohne
onError→ der Render wird abgebrochen. FügeonErrorhinzu oder stelle sicher, dass das Asset vor dem Rendern existiert. useCurrentFrame()/useVideoConfig()außerhalb einer Komposition → wirft einen Fehler. Rufe sie nur innerhalb von Kompositionskomponenten auf.