Jamdesk Documentation logo

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 ![alt](path) 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">:

![Never Gonna Give You Up](/videos/never-gonna-give-you-up.mp4)

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

PropTipoPadrãoDescrição
srcstringnoneObrigatório. Caminho para o arquivo de vídeo.
titlestringnoneRótulo de acessibilidade para leitores de tela.
controlsbooleantrueExibe os controles integrados do player do navegador.
autoPlaybooleanfalseInicia a reprodução assim que o vídeo fica visível.
mutedbooleanfalseInicia com o áudio silenciado.
loopbooleanfalseReinicia desde o começo quando o vídeo termina.
widthstringnoneValor de largura CSS (por exemplo, "400px", "100%").
heightstringnoneValor 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

FormatoExtensãoCompatibilidade com navegadores
MP4 (H.264).mp4Todos os navegadores, incluindo Safari e iOS
WebM (VP9).webmChrome, 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.

Comprima os vídeos antes de adicioná-los ao repositório. Ferramentas como FFmpeg e Handbrake reduzem o tamanho dos arquivos sem perda perceptível de qualidade: ffmpeg -i input.mp4 -crf 28 -preset slow output.mp4

O que vem a seguir?

Imagens

Imagens Markdown, dimensões e legendas

Incorporações do YouTube

Vídeos e Shorts do YouTube

iFrames

Vimeo, CodePen, Figma e muito mais