Produção HyperFrames
Implementa um storyboard aprovado. Se não houver storyboard, pare e execute motion-storyboard.
Escolha o renderizador
| Situação | Renderizador |
|---|---|
| Padrão para novos trabalhos; habilidades em HTML/CSS/GSAP; blocos de registro desejados | HyperFrames (npx hyperframes …) |
| O projeto já usa Remotion | permaneça no Remotion; as mesmas regras de determinismo se aplicam |
Um repositório de produto já tem seu próprio estúdio (seek(t) + Playwright + FFmpeg) | use esse estúdio; não introduza um segundo |
| Edição pura de material existente | pule esta skill → video-edit-qc |
Instalar a CLI do HyperFrames ou adicionar blocos de registro (npx hyperframes add …) instala código de terceiros: confirme com o usuário primeiro e fixe a versão em package.json. Não execute comandos de auto-atualização para skills (npx hyperframes skills update, npx skills add …) por conta própria.
Contrato de composição (HyperFrames)
- Raiz independente:
<div data-composition-id="main" data-width="1920" data-height="1080" data-duration="24">diretamente no<body>, dimensionado comwidth/height: 100%— nunca codifique o tamanho em pixels na raiz. Subcomposições (carregadas viadata-composition-src) envolvem sua raiz em<template>e mantêm seu<style>/<script>dentro dele. - Uma timeline pausada por composição:
window.__timelines["<composition-id>"] = gsap.timeline({ paused: true }), registrada após a construção terminar (pode ser construída dentro dedocument.fonts.ready). A duração da renderização vem dodata-durationda raiz. - Clipes temporizados: elementos com
class="clip"edata-start/data-durationsão mostrados e ocultados pelo runtime. Nunca faça tween dedisplay,visibilityouautoAlphaem um.clip; anime um filho. - Transformações: nunca emparelhe um
transformCSS inicial com um tween GSAP na mesma propriedade; usegsap.fromTo. Centralize com flex/inset, nãotranslate(-50%,-50%)em um nó que você também move. - Mídia: todo
<audio>tem umid(caso contrário, a renderização fica silenciosa); semcrossoriginem mídia; não coloquedata-starttanto em um<video>quanto em um ancestral. - Fontes: toda
font-familynomeada tem um@font-faceno arquivo apontando para um arquivo local enviado. - Determinismo: sem leituras de relógio de parede,
Math.randomnão semeado, buscas de rede em tempo de renderização, estado de entrada ou repetições infinitas (repeat: -1). Use um PRNG semeado quando aleatoriedade for necessária. - Ids: únicos em toda a página montada; prefixe ids de subcomposição com o id da composição.
Ordem de construção
npx hyperframes init(após confirmação) ou abra o projeto existente.- Escreva uma especificação de design (
frame.md/design.md): tokens, escala tipográfica, grade, áreas seguras, por proporção de tela. Primeiro os quadros de repouso — cada batida deve funcionar como uma imagem estática. - Construa cena por cena na ordem do storyboard; implemente as emendas do mapa de transição (
motion-choreography), primeiro os portadores. - Coloque o áudio de
voice-video-sync: base musical, VO, SFX com ids e tempos de início do arquivo de timeline — nunca palpites digitados manualmente. - Mantenha o texto nítido: mova contêineres, não glifos; sem
will-changeem texto.
Validar
Execute nesta ordem e corrija antes de prosseguir:
npx hyperframes lint # erros de contrato; um erro de lint desabilita as auditorias de layout/contraste
npx hyperframes check # layout, estouro, contraste
npx hyperframes snapshot # imagens estáticas para revisão; compare com as batidas do storyboard
npx hyperframes preview # pré-visualização local para o usuário
Em seguida, renderize localmente: npx hyperframes render --quality <draft|high>. Primeiro o rascunho (janela ≤30 s ou baixa qualidade) para aprovação do usuário, depois o final.
Comandos voltados para o exterior — publish, cloud, lambda, cloudrun, feedback, auth e configurações de telemetria — enviam dados ou alteram contas. Execute-os apenas quando o usuário solicitar.
Pipeline personalizado seek(t) (quando não estiver usando HyperFrames)
composition(t) → Playwright page.evaluate(seek, t) → esperar fontes/imagens → captura de tela
→ N subquadros por quadro de saída → ffmpeg tmix (desfoque de movimento) → x264/x265 → multiplexar áudio
- 60 fps × 4 subquadros, obturador 0.5, é um bom padrão; remova o desfoque em quadros onde números mudam se prejudicar a legibilidade.
- Codificação mestre (arquivo e fonte para reedição):
-c:v libx264 -pix_fmt yuv420p -crf 16 -preset slow, AAC 320 kbps. As codificações de entrega para plataformas são derivadas dela emvideo-edit-qc. - O mesmo timestamp renderizado duas vezes deve produzir pixels idênticos; teste em 3 quadros aleatórios.
Entrega
Entregue a renderização mais as imagens estáticas/folha de contato para video-edit-qc. Quando skills do HyperFrames estiverem instaladas (hyperframes-core, hyperframes-animation, hyperframes-creative, hyperframes-cli), use-as para flags exatas, adaptadores (Lottie, Three.js, …) e nomes de blocos de registro.