Vorlagen
Eine Vorlage ist ein wiederverwendbares Design. Sie liest Shot-Props und aufgelöste Tokens – und nichts weiter. Lies motion-style, bevor du Timings oder Easing wählst. Für Details zur Remotion-API verwende die installierten Remotion-Fähigkeiten (npx remotion skills add) oder https://www.remotion.dev/docs.
Wo sie abgelegt wird
- Kundenspezifisch: Beginne mit
pnpm mg new-template <client> <name>. Es erstellt einen funktionierenden Starter unterclients/<client>/templates/<name>/index.tsx(ID<client>/<name>), der dem untenstehenden Vertrag folgt; ersetze sein Design. - Firmenweit (alle Kunden):
templates/<name>/index.tsxim motion-toolkit-Repository, registriert intemplates/index.ts, veröffentlicht mit einer neuen Toolkit-Version. Schreibe nicht innode_modules.
Bevor du Animationscode schreibst, schlage das Schema vor (die Props, die der Benutzer ohne Agent ändern kann) und bestätige es mit dem Benutzer.
Vertrag
import { interpolate, useCurrentFrame } from "remotion";
import { z } from "zod";
import { color, defineTemplate, font, motion, px, safeArea } from "motion-toolkit/engine";
const schema = z.object({
headline: z.string().min(1).default("Überschrift"),
holdSeconds: z.number().positive().default(3),
accent: z.string().default("accent").describe("Farbtokenname oder #hex"),
});
export const template = defineTemplate({
title: "Titelkarte",
schema,
durationSeconds: ({ props, tokens }) => {
const m = motion(tokens, 1);
return m.seconds("enter") + props.holdSeconds + m.seconds("exit");
},
check: ({ props, tokens }) => {
color(tokens, props.accent); // wirft Fehler bei unbekannten Tokennamen; läuft in `mg check`
},
component: ({ props, tokens, video }) => {
const frame = useCurrentFrame();
const m = motion(tokens, video.fps);
// ...
},
});
Anforderungen:
- Exportiere
template(Client-Vorlagen) erstellt mitdefineTemplate. - Jedes Schemafeld hat einen
.default()-Wert, sodass neue Shots und das Studio gültig starten. Füge.describe()für das Studio-Formular hinzu. - Farben über
color(tokens, nameOrHex), Schriftarten überfont(tokens, role), Dauern und Easing übermotion(tokens, fps), Positionen innerhalbsafeArea(tokens, video), Größen überpx(sizeAt1080, video). - Animiere nur mit
useCurrentFrame()undinterpolate/spring. Keine CSS-Übergänge,setTimeout,Date.now()oderMath.random()(verwenderandom(seed)von remotion). Renderings müssen jedes Mal identisch sein. - Lasse den Hintergrund transparent, es sei denn, die Vorlage ist ein Vollbild; Lower Thirds und Overlays rendern mit Alpha. Jedes Element muss im letzten Frame verschwunden sein.
- Fehler laut ausgeben: Wirf einen
Errormit einem Lösungshinweis, wenn Text nicht passt oder ein Token fehlt. VerwendeassertFits/wrapLinesaus der Engine; sie messen mit der geladenen Schriftart und werfen bei Überlauf einen Fehler. - Props, die Tokens benennen (Farben, Logos, Schriftarten, Sounds), werden in
checkmitcheckRefsvalidiert, sodassmg checkTippfehler vor dem Rendern abfängt. durationSecondsundchecklaufen in Node (mg check) und bevor Schriftarten geladen sind: Miss dort niemals Text.- Bilder und Logos:
<Img src={staticFile(tokens.logos[name])} />oderstaticFile(props.someAsset). Sounds:<Html5Audio src={staticFile(file)} />innerhalb eines<Sequence from={frame}>, Dateien austokens.sounds[name]. Die CLI stellt die Dateien bereit.
Looks
Firmenvorlagen und Client-Vorlagen, die dazu passen sollen, nehmen look: lookSchema entgegen und lösen es mit resolveLook(props.look, tokens) auf. Baue sie mit den gemeinsamen Helfern, sodass alle drei Looks konsistent bleiben (siehe motion-style):
choreo(tokens, look, fps)gibtbeat(frame, index, exitStart, steps)→{ inP, outP }für jedes Element in der Eingabereihenfolge;choreoSeconds(...)liefert die passende Dauer.reveal(look, beat, video)ist der Eingangsstil des Looks für ein Element (umwickele es mitoverflow: hiddenfürcorporate).typo(tokens, look, "display" | "title" | "body" | "label", size)ist der Typografiestil des Looks;onColor(hex)wählt lesbaren Text auf einem Farbblock;cornerPlacement(corner, inset)positioniert Eckgrafiken.
Lies eine Firmenvorlage wie node_modules/motion-toolkit/templates/title-card/index.tsx als ausführliches Beispiel.
Überprüfen
pnpm mg new-shot <client>/<project> <shot> --template <client>/<name>in einem Testprojekt, plus einen zweiten Shot mit dem längsten realistischen Text.pnpm mg check <client>/<project>.pnpm mg still <client>/<project> <shot>und betrachte die Frames. Dannpnpm mg render.- Folge
motion-qa.
Arbeiten mit einem Referenzclip
Wenn der Benutzer ein Referenzvideo bereitstellt, extrahiere vor dem Entwurf Frames. Erstelle zuerst renders/reference/; das gebündelte ffmpeg ist ein minimaler Build ohne Filter, verwende daher -r für die Bildrate:
pnpm mg ffmpeg -i reference.mp4 -r 10 renders/reference/f_%03d.png
Beschreibe anhand der Frames, was sich bewegt, in welcher Reihenfolge, wie lange jede Phase dauert (zähle Frames bei 10 fps) und wie sich das Easing anfühlt. Bestätige diese Aufschlüsselung mit dem Benutzer und ordne sie dann Tokens zu: Dauern zu motion.durations, Kurven zu motion.easings.