Skip to main content

Biblioteca de vídeos

A biblioteca de vídeos da loja guarda os arquivos enviados pelo lojista, gera miniaturas e entrega reprodução adaptativa (HLS). O tema referencia vídeos pelo campo video no schema — não por URL manual quando o lojista escolhe da biblioteca. Este hub é para autores de tema, agências e agentes de IA trabalhando em Corvex Store V2 (sections React, não Liquid).
V2 é React (section.jsx), não Liquid. A documentação V1 em corvex.mintlify.app usa video_picker + objeto video no Liquid — adapte os conceitos, não copie o markup.

Documentação


Início rápido (lojista)

  1. Editor → campo Vídeo na section → aba Enviar ou Biblioteca.
  2. Envie MP4, MOV ou WebM; aguarde status Pronto.
  3. Ou cole URL do YouTube, Vimeo ou MP4 externo na aba URL.
Arquivos acima de 200 MB não podem ser enviados pelo editor. Comprima o arquivo ou use URL externa.

Início rápido (autor de tema / LLM)

1. Schema

video e video_url são equivalentes no Editor. O tipo ainda é experimental — veja Schema overview.

2. Section React

CorvexVideo não vem da plataforma. Crie o snippet no tema. Para UUID da biblioteca, o snippet chama useCorvexVideoPlayback de @corvex/theme-sdk.

3. Blocks

Cada block com video salva o valor em block.settings.videoId (ou o id que você definiu). Não existe mapa videos[block.id] como na V1 Liquid — use settings do block diretamente. Detalhes: Schema · Implementação: Padrões.

Quando usar o quê


Valor salvo no JSON

O campo video persiste uma string: O SDK exporta a mesma classificação em classifyVideoValue (@corvex/theme-sdk). O tema não precisa duplicar o regex:

Checklist

  • type: "video" quando o lojista escolhe o arquivo
  • classifyVideoValue() antes de renderizar <video>
  • Poster (image) quando vídeo da biblioteca ainda processa ou UUID sem playback
  • muted + playsInline em autoplay
  • prefers-reduced-motion desliga autoplay
  • Carrossel: pausar slides inativos
  • aspect-ratio no CSS — evitar CLS
  • Snippet CorvexVideo reutilizado em várias sections
  • Cleanup no useEffect (pause, remover src)

Erros comuns

Ver tabela completa em FAQ.

Leitura relacionada