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.