Skip to main content

Padrões de vídeo

Catálogo de implementações para temas V2 React. Todos usam type: "video" + classificação do valor. Ver Schema.

Snippet reutilizável — CorvexVideo

Use o Theme SDK: useCorvexVideoPlayback e classifyVideoValue de @corvex/theme-sdk. Não implemente fetch manual de playback no block. Centralize no snippet.Sections com vários vídeos (carrossel Reels, marquee): leia Carrossel de vídeos antes de implementar — erros de ciclo de vida do HLS só aparecem na vitrine publicada.
Crie snippets/corvex-video/snippet.jsx no seu tema:
Importe no tema:

Hero Video

sections/hero-video/schema.json (trecho):
section.jsx (trecho):

Background Video

Vídeo decorativo — sem controles, sempre muted.

Video Card Reels (9:16)

Block reel — play no clique, um vídeo ativo por vez:
Na section pai, pause outros cards ao iniciar um (estado local ou context).

Carrossel com vídeo

Pausar vídeos em slides inativos:
Use preload="none" e data-src em vez de src até o slide ficar ativo.

Carrossel de vídeos (Reels / marquee)

Vários cards com type: "video" + autoplay exigem o guia dedicado: Resumo:
  1. Snippet CorvexVideo com useCorvexVideoPlayback
  2. HLS: efeito separado para src vs shouldPlay
  3. Marquee: playWhenVisible={false}
  4. corvex build, depois corvex sync, depois Publicar no editor

Índice rápido


Leitura relacionada