Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

autoplay: pedir reprodução automática

Pede o início preservando o controlo do utilizador e respeitando as regras de reprodução.

Versão: HTML Living Standard

Sintaxe

<video autoplay muted playsinline controls></video>

O atributo booleano autoplay pede a reprodução automática de um recurso de áudio ou vídeo quando esta puder começar. A presença ativa o pedido: escrever autoplay="false" não o desativa. As regras do navegador, as preferências do utilizador, a disponibilidade do conteúdo e um documento que o incorpora podem ainda impedir a reprodução. O pedido não promete que o som comece sem interação.

O vídeo sem som é frequentemente permitido quando a reprodução audível é bloqueada, mas muted não contorna universalmente as restrições. Disponibiliza controlos e um início manual utilizável, evitando surpresas ou interferências com tecnologias de apoio. playsinline diz respeito à apresentação do vídeo dentro da página nos dispositivos aplicáveis; não concede autorização para reprodução automática.

O exemplo liga a um vídeo sem som um fluxo criado a partir de um canvas local. A reprodução começa sem chamar o respetivo método, e o gestor regista o estado e as dimensões antes de parar o fluxo. Isto foi verificado em Chromium 145; um ficheiro multimédia real, som ou regras de navegador diferentes exigem uma verificação própria.

Exemplos

<!doctype html><meta charset="utf-8">
<canvas id="image" width="40" height="30"></canvas>
<video id="video" autoplay muted playsinline controls></video><output id="result"></output>
<script>
const canvas = document.querySelector('#image');
canvas.getContext('2d').fillRect(0, 0, 40, 30);
const video = document.querySelector('#video');
video.addEventListener('playing', () => {
  document.querySelector('#result').textContent = 'playing=' + !video.paused + '; muted=' + video.muted + '; width=' + video.videoWidth;
  video.srcObject.getTracks().forEach(track => track.stop());
}, { once: true });
// A local canvas stream: no camera, microphone or downloaded movie.
video.srcObject = canvas.captureStream(1);
</script>

Resultado

playing=true; muted=true; width=40

É usado apenas um fluxo de canvas local. O resultado confirma este caso sem som, não uma reprodução sonora automática sem restrições.

Fontes