Modèles
Un modèle est un design réutilisable. Il lit les props d'un plan et les tokens résolus, et rien d'autre. Lisez motion-style avant de choisir les timings ou les easing. Pour les détails de l'API Remotion, utilisez les compétences Remotion si elles sont installées (npx remotion skills add) ou https://www.remotion.dev/docs.
Où le placer
- Spécifique à un client : commencez par
pnpm mg new-template <client> <nom>. Cela génère un squelette fonctionnel dansclients/<client>/templates/<nom>/index.tsx(id<client>/<nom>) qui respecte le contrat ci-dessous ; remplacez son design. - Maison (tous les clients) :
templates/<nom>/index.tsxdans le dépôt motion-toolkit, enregistré danstemplates/index.ts, publié avec une nouvelle version du toolkit. N'écrivez pas dansnode_modules.
Avant d'écrire le code d'animation, proposez le schéma (les props que l'utilisateur pourra modifier sans agent) et confirmez-le avec l'utilisateur.
Contrat
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("Titre"),
holdSeconds: z.number().positive().default(3),
accent: z.string().default("accent").describe("Nom du token de couleur ou #hex"),
});
export const template = defineTemplate({
title: "Carton titre",
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); // lève une erreur si le token est inconnu ; s'exécute dans `mg check`
},
component: ({ props, tokens, video }) => {
const frame = useCurrentFrame();
const m = motion(tokens, video.fps);
// ...
},
});
Exigences :
- Exportez
template(modèles clients) construit avecdefineTemplate. - Chaque champ du schéma a une valeur
.default()pour que les nouveaux plans et le Studio démarrent valides. Ajoutez.describe()pour le formulaire Studio. - Couleurs via
color(tokens, nameOrHex), polices viafont(tokens, role), durées et easing viamotion(tokens, fps), positions danssafeArea(tokens, video), tailles viapx(sizeAt1080, video). - Animer uniquement à partir de
useCurrentFrame()avecinterpolate/spring. Pas de transitions CSS,setTimeout,Date.now()ouMath.random()(utilisezrandom(seed)de remotion). Les rendus doivent être identiques à chaque fois. - Laissez l'arrière-plan transparent sauf si le modèle est plein écran ; les tiers inférieurs et les incrustations se rendent avec alpha. Chaque élément doit être invisible sur la dernière image.
- Échouez bruyamment : lancez une
Erroravec une indication de correction lorsque le texte ne tient pas ou qu'un token est manquant. UtilisezassertFits/wrapLinesdu moteur ; ils mesurent avec la police chargée et lèvent une erreur en cas de débordement. - Les props qui nomment des tokens (couleurs, logos, polices, sons) sont validées dans
checkaveccheckRefs, afin quemg checkdétecte les fautes de frappe avant le rendu. durationSecondsetchecks'exécutent dans Node (mg check) et avant le chargement des polices : ne mesurez jamais de texte ici.- Images et logos :
<Img src={staticFile(tokens.logos[nom])} />oustaticFile(props.someAsset). Sons :<Html5Audio src={staticFile(fichier)} />dans une<Sequence from={frame}>, fichiers issus detokens.sounds[nom]. Le CLI prépare les fichiers.
Looks
Les modèles maison, et les modèles clients destinés à leur correspondre, prennent look: lookSchema et le résolvent avec resolveLook(props.look, tokens). Construisez-les à partir des helpers partagés pour que les trois looks restent cohérents (voir motion-style) :
choreo(tokens, look, fps)donnebeat(frame, index, exitStart, steps)→{ inP, outP }pour chaque élément dans l'ordre d'entrée ;choreoSeconds(...)donne la durée correspondante.reveal(look, beat, video)est le style d'entrée du look pour un élément (entourez-le deoverflow: hiddenpourcorporate).typo(tokens, look, "display" | "title" | "body" | "label", size)est le style typographique du look ;onColor(hex)choisit une couleur de texte lisible sur un bloc de couleur ;cornerPlacement(corner, inset)positionne les graphiques de coin.
Lisez un modèle maison tel que node_modules/motion-toolkit/templates/title-card/index.tsx comme exemple concret.
Vérification
pnpm mg new-shot <client>/<projet> <plan> --template <client>/<nom>dans un projet de test, plus un deuxième plan avec le texte réaliste le plus long.pnpm mg check <client>/<projet>.pnpm mg still <client>/<projet> <plan>et regardez les images. Ensuitepnpm mg render.- Suivez
motion-qa.
Travailler à partir d'une vidéo de référence
Lorsque l'utilisateur fournit une vidéo de référence, extrayez les images avant de concevoir. Créez d'abord renders/reference/ ; le ffmpeg intégré est une version minimale sans filtres, donc utilisez -r pour la fréquence d'images :
pnpm mg ffmpeg -i reference.mp4 -r 10 renders/reference/f_%03d.png
Décrivez à partir des images ce qui bouge, dans quel ordre, combien de temps dure chaque phase (comptez les images à 10 ips), et la sensation de l'easing. Confirmez cette décomposition avec l'utilisateur, puis mappez-la sur des tokens : durées vers motion.durations, courbes vers motion.easings.