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 campovideo 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).
Documentação
Início rápido (lojista)
- Editor → campo Vídeo na section → aba Enviar ou Biblioteca.
- Envie MP4, MOV ou WebM; aguarde status Pronto.
- 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 comvideo 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 campovideo 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+playsInlineem autoplay -
prefers-reduced-motiondesliga autoplay - Carrossel: pausar slides inativos
-
aspect-rationo CSS — evitar CLS - Snippet
CorvexVideoreutilizado em várias sections - Cleanup no
useEffect(pause, removersrc)
Erros comuns
Ver tabela completa em FAQ.
Leitura relacionada
- Field type
video - Erros comuns (data)
- Schema de section
AGENTS.mdna pasta da documentação