Vídeos
Aprenda a incorporar vídeos MP4 e WebM no Jamdesk usando Markdown ou o componente Video, com opções de reprodução automática, repetição e controles.
Armazene arquivos .mp4 ou .webm em um diretório /videos dentro do projeto e referencie-os diretamente. O Jamdesk renderiza um player HTML5 com controles, cantos arredondados e espaçamento consistente.
As capturas de tela mostram a interface em inglês.
Sintaxe do Markdown
O mesmo padrão  usado para imagens também funciona com arquivos de vídeo. O Jamdesk verifica a extensão do arquivo e renderiza um player de vídeo em vez de uma tag <img loading="lazy">:

Você obtém um player padrão com reprodução/pausa, volume, barra de progresso e tela cheia. Use o componente <Video> para controlar a reprodução (reprodução automática, repetição e silenciamento).
Componente de vídeo
O componente <Video> expõe atributos de vídeo HTML5 como props:
<Video src="/_jd/videos/never-gonna-give-you-up.mp4?v=mwdojjfh" title="Rick Astley" />
A prop title define o aria-label no elemento de vídeo. Os leitores de tela anunciam esse rótulo. Sempre inclua um.
Propriedades
| Prop | Tipo | Padrão | Descrição |
|---|---|---|---|
src | string | none | Obrigatório. Caminho para o arquivo de vídeo. |
title | string | none | Rótulo de acessibilidade para leitores de tela. |
controls | boolean | true | Exibe os controles integrados do player do navegador. |
autoPlay | boolean | false | Inicia a reprodução assim que o vídeo fica visível. |
muted | boolean | false | Inicia com o áudio silenciado. |
loop | boolean | false | Reinicia desde o começo quando o vídeo termina. |
width | string | none | Valor de largura CSS (por exemplo, "400px", "100%"). |
height | string | none | Valor de altura CSS. |
Substituição de GIFs
Uma gravação de interface de 5 segundos pode ocupar 10 MB como GIF e menos de 500 KB como MP4. Substitua GIFs por um vídeo sem som em repetição e oculte os controles do player:
<Video src="/_jd/videos/ui-demo.mp4?v=mwdojjfh" autoPlay muted loop controls={false} />
O resultado funciona como um GIF (é reproduzido em linha, fica em repetição contínua e não tem controles). O carregamento é mais rápido e a imagem permanece nítida em qualquer resolução.
Os navegadores bloqueiam a reprodução automática com som. Um vídeo com autoPlay e sem muted não será reproduzido. Ele permanecerá no primeiro quadro sem exibir erro. Sempre defina muted junto com autoPlay.
Formatos compatíveis
| Formato | Extensão | Compatibilidade com navegadores |
|---|---|---|
| MP4 (H.264) | .mp4 | Todos os navegadores, incluindo Safari e iOS |
| WebM (VP9) | .webm | Chrome, Firefox, Edge. Arquivos menores com qualidade comparável |
MP4 é a opção mais segura. Todos os navegadores e dispositivos reproduzem esse formato. WebM gera arquivos menores. Safari e iOS não reproduzem WebM. Leitores em dispositivos Apple não verão o vídeo.
Os arquivos de vídeo podem ter até 100MB. Hospede no YouTube qualquer vídeo com mais de alguns minutos e use o componente <YouTube>. Uma CDN projetada para transmitir vídeo entrega o conteúdo mais rápido do que a documentação consegue servir um arquivo grande.
