Production HyperFrames
Implémente un storyboard approuvé. S'il n'y a pas de storyboard, arrêtez-vous et exécutez motion-storyboard.
Choisir le moteur de rendu
| Situation | Moteur de rendu |
|---|---|
| Par défaut pour un nouveau projet ; compétences HTML/CSS/GSAP ; blocs de registre souhaités | HyperFrames (npx hyperframes …) |
| Le projet utilise déjà Remotion | restez sur Remotion ; les mêmes règles de déterminisme s'appliquent |
Un dépôt produit a déjà son propre studio (seek(t) + Playwright + FFmpeg) | utilisez ce studio ; n'en introduisez pas un second |
| Montage pur de séquences existantes | ignorez cette compétence → video-edit-qc |
L'installation de la CLI HyperFrames ou l'ajout de blocs de registre (npx hyperframes add …) installe du code
tiers : confirmez avec l'utilisateur au préalable et verrouillez la version dans package.json. N'exécutez pas
de commandes de mise à jour automatique pour les compétences (npx hyperframes skills update, npx skills add …) par vous-même.
Contrat de composition (HyperFrames)
- Racine autonome :
<div data-composition-id="main" data-width="1920" data-height="1080" data-duration="24">directement dans<body>, dimensionnéwidth/height: 100%— ne codez jamais en dur la taille en pixels sur la racine. Sous-compositions (chargées viadata-composition-src) enveloppent leur racine dans<template>et gardent leur<style>/<script>à l'intérieur. - Une timeline en pause par composition :
window.__timelines["<composition-id>"] = gsap.timeline({ paused: true }), enregistrée après la fin de la construction (elle peut être construite à l'intérieur dedocument.fonts.ready). La durée du rendu provient de l'attributdata-durationde la racine. - Clips chronométrés : les éléments avec
class="clip"etdata-start/data-durationsont affichés et masqués par le moteur d'exécution. Ne tweetez jamaisdisplay,visibility, ouautoAlphasur un.clip; animez un enfant. - Transformations : ne couplez jamais une
transformCSS initiale avec un tween GSAP sur la même propriété ; utilisezgsap.fromTo. Centrez avec flex/inset, pastranslate(-50%,-50%)sur un nœud que vous déplacez aussi. - Médias : chaque
<audio>a unid(sinon le rendu est silencieux) ; pas decrossoriginsur les médias ; ne mettez pasdata-startà la fois sur une<video>et un ancêtre. - Polices : chaque
font-familynommée a une@font-facedans le fichier pointant vers un fichier local livré. - Déterminisme : pas de lectures d'horloge,
Math.randomnon ensemencé, de requêtes réseau au moment du rendu, d'état d'entrée, ou de répétitions infinies (repeat: -1). Utilisez un PRNG ensemencé lorsque le hasard est nécessaire. - Ids : uniques sur toute la page assemblée ; préfixez les ids des sous-compositions avec l'id de la composition.
Ordre de construction
npx hyperframes init(après confirmation) ou ouvrez le projet existant.- Rédigez un cahier des charges de conception (
frame.md/design.md) : jetons, échelle typographique, grille, zones de sécurité, par rapport d'aspect. Images au repos d'abord — chaque temps doit fonctionner comme une image fixe. - Construisez scène par scène dans l'ordre du storyboard ; implémentez les jonctions à partir de la carte de transition
(
motion-choreography), d'abord les supports. - Placez l'audio à partir de
voice-video-sync: fond musical, VO, effets sonores avec ids et heures de début provenant du fichier de chronologie — jamais de suppositions tapées à la main. - Gardez le texte net : déplacez les conteneurs, pas les glyphes ; pas de
will-changesur le texte.
Valider
Exécutez dans cet ordre et corrigez avant de passer à la suite :
npx hyperframes lint # erreurs de contrat ; une erreur de lint désactive les audits de mise en page/contraste
npx hyperframes check # mise en page, débordement, contraste
npx hyperframes snapshot # images fixes pour révision ; comparer avec les temps du storyboard
npx hyperframes preview # aperçu local pour l'utilisateur
Ensuite, effectuez le rendu localement : npx hyperframes render --quality <brouillon|haute>. D'abord le brouillon (≤30 s de fenêtre ou
faible qualité) pour l'approbation de l'utilisateur, puis le final.
Les commandes externes — publish, cloud, lambda, cloudrun, feedback, auth, et
paramètres de télémétrie — téléchargent des données ou changent de comptes. Exécutez-les uniquement lorsque l'utilisateur le demande.
Pipeline personnalisé seek(t) (lorsque vous n'utilisez pas HyperFrames)
composition(t) → Playwright page.evaluate(seek, t) → attendre polices/images → capture d'écran
→ N sous-images par image de sortie → ffmpeg tmix (flou de mouvement) → x264/x265 → multiplexage audio
- 60 ips × 4 sous-images, obturateur 0.5, est une bonne valeur par défaut ; supprimez le flou sur les images où les nombres changent si cela nuit à la lisibilité.
- Encodage maître (archive et source de réédition) :
-c:v libx264 -pix_fmt yuv420p -crf 16 -preset slow, AAC 320 kbps. Les encodages de livraison pour plateforme en sont dérivés dansvideo-edit-qc. - La même heure rendue deux fois doit produire des pixels identiques ; testez-la sur 3 images aléatoires.
Remise
Livrez le rendu ainsi que les images fixes/planche contact à video-edit-qc. Lorsque les compétences HyperFrames sont
installées (hyperframes-core, hyperframes-animation, hyperframes-creative, hyperframes-cli),
utilisez-les pour les indicateurs exacts, les adaptateurs (Lottie, Three.js, …), et les noms de blocs de registre.