HyperFrames Produktion
Implementiert ein genehmigtes Storyboard. Wenn kein Storyboard vorhanden ist, anhalten und motion-storyboard ausführen.
Renderer auswählen
| Situation | Renderer |
|---|---|
| Standard für neue Arbeiten; HTML/CSS/GSAP-Kenntnisse; Registry-Blöcke erwünscht | HyperFrames (npx hyperframes …) |
| Das Projekt verwendet bereits Remotion | bei Remotion bleiben; die gleichen Determinismusregeln gelten |
Ein Produkt-Repo hat bereits sein eigenes Studio (seek(t) + Playwright + FFmpeg) | dieses Studio verwenden; kein zweites einführen |
| Reine Bearbeitung vorhandenen Filmmaterials | diesen Skill überspringen → video-edit-qc |
Die Installation der HyperFrames CLI oder das Hinzufügen von Registry-Blöcken (npx hyperframes add …) installiert Code von Drittanbietern: zuerst mit dem Benutzer bestätigen und die Version in package.json fixieren. Keine Self-Update-Befehle für Skills ausführen (npx hyperframes skills update, npx skills add …).
Kompositionsvertrag (HyperFrames)
- Eigenständige Wurzel:
<div data-composition-id="main" data-width="1920" data-height="1080" data-duration="24">direkt im<body>, mitwidth/height: 100%dimensioniert – niemals Pixelgröße auf der Wurzel hartcodieren. Sub-Kompositionen (geladen überdata-composition-src) umschließen ihre Wurzel mit<template>und behalten ihr<style>/<script>darin. - Eine pausierte Timeline pro Komposition:
window.__timelines["<composition-id>"] = gsap.timeline({ paused: true }), registriert nach Abschluss des Builds (kann innerhalb vondocument.fonts.readyerstellt werden). Die Renderlänge ergibt sich aus demdata-duration-Attribut der Wurzel. - Zeitgesteuerte Clips: Elemente mit
class="clip"unddata-start/data-durationwerden von der Laufzeit ein- und ausgeblendet. Niemalsdisplay,visibilityoderautoAlphaauf einem.cliptweenen; ein Kind-Element animieren. - Transformationen: Niemals ein CSS-Initial-
transformmit einem GSAP-Tween auf derselben Eigenschaft kombinieren;gsap.fromToverwenden. Mit Flex/inset zentrieren, nichttranslate(-50%,-50%)auf einem Knoten, den man auch bewegt. - Medien: Jedes
<audio>hat eineid(sonst ist der Render stumm); keincrossoriginauf Medien;data-startnicht sowohl auf einem<video>als auch auf einem Vorfahren platzieren. - Schriftarten: Jede benannte
font-familyhat ein entsprechendes@font-faceinnerhalb der Datei, das auf eine ausgelieferte lokale Datei verweist. - Determinismus: Keine wall-clock-Lesevorgänge, unseeded
Math.random, Netzwerkabfragen zur Renderzeit, Eingabezustände oder unendliche Wiederholungen (repeat: -1). Bei Bedarf Zufallszahlen mit einem seeded PRNG erzeugen. - Ids: Einzigartig auf der gesamten Seite; Sub-Kompositions-IDs mit der Kompositions-ID präfixieren.
Build-Reihenfolge
npx hyperframes init(nach Bestätigung) oder das bestehende Projekt öffnen.- Eine Design-Spezifikation schreiben (
frame.md/design.md): Tokens, Schriftskala, Raster, sichere Bereiche, pro Seitenverhältnis. Zuerst Ruhe-Frames – jeder Beat muss als Standbild funktionieren. - Szene für Szene in Storyboard-Reihenfolge aufbauen; Nähte aus der Transitionskarte (
motion-choreography) implementieren, zuerst Träger. - Audio aus
voice-video-syncplatzieren: Musikbett, Voice-Over, Soundeffekte mit IDs und Startzeiten aus der Timeline-Datei – niemals handschriftliche Schätzungen. - Text gestochen scharf halten: Container verschieben, nicht Glyphen; kein
will-changeauf Text.
Validieren
In dieser Reihenfolge ausführen und vor dem Weitermachen korrigieren:
npx hyperframes lint # Vertragsfehler; ein Lint-Fehler deaktiviert die Layout-/Kontrastprüfungen
npx hyperframes check # Layout, Überlauf, Kontrast
npx hyperframes snapshot # Standbilder zur Überprüfung; mit Storyboard-Beats vergleichen
npx hyperframes preview # Lokale Vorschau für den Benutzer
Dann lokal rendern: npx hyperframes render --quality <draft|high>. Zuerst Entwurf (≤30 s Fenster oder niedrige Qualität) zur Freigabe durch den Benutzer, dann das finale Rendering.
Nach außen gerichtete Befehle – publish, cloud, lambda, cloudrun, feedback, auth und Telemetrie-Einstellungen – laden Daten hoch oder ändern Konten. Sie nur ausführen, wenn der Benutzer darum bittet.
Benutzerdefinierte seek(t)-Pipeline (wenn HyperFrames nicht verwendet wird)
composition(t) → Playwright page.evaluate(seek, t) → auf Schriftarten/Bilder warten → Screenshot
→ N Unterframes pro Ausgabeframe → ffmpeg tmix (Bewegungsunschärfe) → x264/x265 → Audio muxen
- 60 fps × 4 Unterframes, Verschluss 0.5, ist eine gute Voreinstellung; Unschärfe bei Frames verringern, in denen sich Zahlen ändern, falls die Lesbarkeit leidet.
- Master-Encode (Archiv und Quelle für Nachbearbeitung):
-c:v libx264 -pix_fmt yuv420p -crf 16 -preset slow, AAC 320 kbps. Plattformlieferungs-Encodes werden daraus invideo-edit-qcabgeleitet. - Derselbe Zeitstempel, zweimal gerendert, muss identische Pixel erzeugen; auf 3 zufälligen Frames testen.
Übergabe
Den Render zusammen mit den Standbildern / dem Kontaktbogen an video-edit-qc übergeben. Wenn HyperFrames-Skills installiert sind (hyperframes-core, hyperframes-animation, hyperframes-creative, hyperframes-cli), diese für genaue Flags, Adapter (Lottie, Three.js, …) und Registry-Blöcke verwenden.