Was macht HyperFrames?
Übersicht
HyperFrames ist ein quelloffenes (Apache-2.0) Framework von HeyGen, das HTML, CSS, Medien und Animationen in deterministische MP4-Videos umwandelt – identische Eingabe erzeugt stets identische Ausgabe. Es parst HTML-Kompositionen, die mit data-*-Timing-Attributen annotiert sind, steuert Headless Chrome zum Suchen und Erfassen jedes Frames und codiert das Ergebnis mit FFmpeg. Es gibt keinen Build-Schritt, keine React-Anforderung und keine Gebühr pro Render. Es ist agentenfreundlich konzipiert: Die CLI ist standardmäßig nicht interaktiv, sodass sie sich nahtlos in automatisierte Content-Pipelines einfügt.
Verwende dieses Skill, um Projekte zu erstellen, HTML-Kompositionen zu verfassen, sie mit Live-Reload in der Vorschau anzuzeigen und frame-genaue Videos zu rendern – einschließlich Animationen, die mit GSAP, CSS, Lottie, Three.js, Anime.js oder der Web Animations API erstellt wurden.
Anleitung
Voraussetzungen
Überprüfe die Umgebung vor dem Start:
- Node.js 22+ (
node --version) - FFmpeg im PATH (
ffmpeg -version) - Headless Chrome/Chromium wird von der Engine beim ersten Start heruntergeladen.
Ein Projekt erstellen
npx hyperframes init my-video # Projekt anlegen (erstellt index.html + package.json)
cd my-video
Für die agentengesteuerte Einrichtung innerhalb eines vorhandenen AI-Agent-Arbeitsbereichs kann das Skill mit npx skills add heygen-com/hyperframes installiert werden.
Eine Komposition verfassen
Kompositionen sind einfache index.html-Dateien. Ein root-stage-Element deklariert die Leinwand und die Kompositions-ID; untergeordnete Elemente deklarieren über data-*-Attribute, wann sie erscheinen und wie lange sie dauern. Zeitwerte sind in Sekunden angegeben.
| Attribut | Zweck |
|---|---|
data-composition-id | Benennt die Komposition (Ziel für render/inspect) |
data-start | Wann das Element in den Timelime eintritt (Sekunden) |
data-duration | Wie lange das Element im Timelime bleibt (Sekunden) |
data-width / data-height | Leinwandabmessungen in Pixeln (am stage-Element) |
data-track-index | Layer-/Track-Reihenfolge für gestapeltes Audio oder Video |
data-volume | Audio-Pegel, 0.0–1.0 |
Vorschau und Rendern
npx hyperframes preview # Browser-Vorschau mit Live-Reload während der Arbeit
npx hyperframes render # Jedes Frame in Headless Chrome suchen, mit FFmpeg zu MP4 codieren
npx hyperframes lint # Kompositionsstruktur vor dem Rendern validieren
npx hyperframes inspect # Metadaten der Komposition ausgeben (Dauer, Tracks, Abmessungen)
Die Auflösung stammt aus data-width/data-height auf der Bühne; Bildrate, Ausgabepfad und Codec sind Render-Parameter (siehe npx hyperframes render --help für die genauen Flags in deiner installierten Version, da sich die Flag-Namen weiterentwickeln). Da die Ausgabe deterministisch ist, ist das erneute Rendern unveränderter Eingaben sicher fürs Caching.
Den Komponentenkatalog verwenden
Vorgefertigte Bausteine (Übergänge, Overlays, Untertitel, animierte Diagramme, Karten, Effekte) werden in das Projekt installiert:
npx hyperframes add flash-through-white # ein Übergang
npx hyperframes add data-chart # ein animierter Diagrammblock
npx hyperframes add instagram-follow # ein Social-Overlay
Durchstöbere den vollständigen Katalog unter hyperframes.heygen.com/catalog und füge dann Blöcke mit add hinzu.
Animationen
Jede suchbare, frame-genaue Animation funktioniert, weil die Engine jede Timelime-Position deterministisch sucht, anstatt in Echtzeit aufzuzeichnen. Unterstützte Adapter: GSAP, CSS-Animationen, Lottie, Three.js, Anime.js, WAAPI und benutzerdefinierte Frame-Adapter. Vermeide zeitbasierte Zufälligkeit oder Date.now()/wanduhrgetriebene Bewegungen – binde den Animationsfortschritt an die Kompositions-Timelime, damit Suchvorgänge reproduzierbar sind.
Agenten-/CI-Pipelines
Die CLI ist nicht interaktiv, sodass ein typischer automatisierter Ablauf folgt: HTML generieren/vorlagen → hyperframes lint → hyperframes render → MP4 sammeln. Für Skalierung ermöglicht das Paket @hyperframes/aws-lambda das verteilte Rendern über Lambda.
Beispiele
Beispiel 1: Eine Produktlaunch-Komposition rendern
index.html:
<div id="stage" data-composition-id="launch"
data-start="0" data-width="1920" data-height="1080">
<video data-start="0" data-duration="6" src="intro.mp4"></video>
<h1 id="title" data-start="1" data-duration="4">Launch day</h1>
<audio data-start="0" data-duration="6" data-volume="0.8" src="music.wav"></audio>
</div>
npx hyperframes inspect # bestätigt: launch, 6s, 1920x1080
npx hyperframes lint # vor dem Rendern validieren
npx hyperframes render # erzeugt ein 1080p MP4
Beispiel 2: Eine suchbare GSAP-Titelanimation
<div id="stage" data-composition-id="title-card"
data-start="0" data-width="1080" data-height="1080">
<h1 id="headline" data-start="0" data-duration="3">Q3 Results</h1>
<script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
<script>
// Binde den Fortschritt an die Timelime (pausierte Tween, die die Engine sucht), nicht an die Echtzeit.
const tl = gsap.timeline({ paused: true });
tl.from("#headline", { y: 80, opacity: 0, duration: 1 })
.to("#headline", { scale: 1.05, duration: 2 });
window.__seek = (t) => tl.seek(t); // Engine ruft dies pro Frame auf
</script>
</div>
npx hyperframes preview # live iterieren, dann:
npx hyperframes render
Richtlinien
- Determinismus zuerst. Binde alle Bewegungen an die Kompositions-Timelime. Vermeide
Math.random(),Date.now(), Echtzeitschleifen oder Netzwerkaufrufe während des Render-Vorgangs – sie zerstören die Reproduzierbarkeit. - Lint vor dem Rendern.
hyperframes linterkennt strukturelle Fehler/Timing-Fehler kostengünstig; das Rendern ist der teure Schritt. - Leinwand auf der Bühne setzen.
data-width/data-heightbefinden sich am Root-Kompositionselement; das Timing untergeordneter Elemente (data-start/data-duration) befindet sich an jedem Element, in Sekunden. - Toolchain überprüfen. Die meisten Fehler lassen sich auf fehlendes FFmpeg oder Node < 22 zurückführen oder auf einen durch eine Firewall blockierten Chromium-Download.
--helpfür genaue Flags verwenden. Die Optionenrender/addvariieren je nach Version; bestätige die Flags für fps/output/codec anhand der installierten CLI, anstatt sie anzunehmen.- Katalogblöcke bevorzugen.
hyperframes addzieht gewartete, suchbare Komponenten heran, anstatt eigene Übergänge und Diagramme von Hand zu erstellen. - Mit Lambda skalieren. Für Stapel-/große Aufträge über
@hyperframes/aws-lambdarendern, anstatt einen langen lokalen Job laufen zu lassen. - Medien lokal und versioniert halten. Assets über stabile Pfade referenzieren; Remote-Abrufe während des Render-Vorgangs untergraben Determinismus und Reproduzierbarkeit.