audio

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.

* Some parts of this feature may have varying levels of support.

Sumário

O elementoaudio é utilizado para embutir conteúdo de som em um documento HTML ou XHTML.O elementoaudio foi adicionado como parte do HTML5.

Você pode utilizar recursos avançados da API de áudio — que são específicas do Gecko — para gerar e manipular diretamente fluxo de áudio a partir do código JavaScript. VejaIntroducing the audio API extension para detalhes.

Contexto de Uso

Conteúdo permitido	Transparent content, tanto um atributo`src` quanto um ou mais elementos`<source>`, seguidos por umflow content ouphrasing content, sem`<video>` ou elementos`<audio>`.
Omissão de tag	Nenhuma, tanto as tags iniciais quanto as finais devem estar presentes.
Elementos pai permitidos	Qualquer elemento que aceiteflow content, ou qualquer elemento que aceitephrasing content.
Documento normativo	HTML5, section 4.8.7

Atributos

Como todos os elementos HTML, este elemento suporta osglobal attributes.

autoplay

Um atributo Booleano; se especificado (mesmo se o valor for "false"!), o áudio iniciará automaticamente assim que possível sem parar de carregar os dados.

autobuffer

Um atributo Booleano; se especificado, o audio será baixado automaticamente, mesmo se não está configurado para reprodução automática. Isto continua até que o cache de mídia esteja cheio, ou até que o o arquivo de áudio completo tenha sido baixado, o que vier primeiro. Isto deve ser utilizado apenas quando é esperado que o usuário escolherá tocar o áudio; por exemplo, se o usuário navegou para a página utilizando um link "Reproduzir". Este atributo foi removido no Gecko 2.0 em razão do atributopreload.

buffered

Um atributo que pode ser lido para determinar os intervalos do áudio que já foram carregados. Este atributo contém um objetoTimeRanges.

controls

Se esse atributo estiver presente, o navegador oferecerá controles para permitir ao usuário controlar a reprodução do áudio, incluindo volume, navegação, e pausa/continuação da reprodução.

loop

Um atributo Booleano; se especificado, ao chegar no fim do áudio, ele voltará automaticamente para o começo.

mozCurrentSampleOffsetNão padrão

The offset, specified as the number of samples since the beginning of the audio stream, at which the audio is currently playing.

muted

Um atributo Booleano que indica se o áudio será inicializado silenciado.

played

Um objetoTimeRangesindicando que todo o áudio foi reproduzido.

preload

Esse atributo enumerado pretende dar uma sugestão ao navegador sobre o que o autor pensa que proporcionará uma melhor experiência do usuário. Ele pode ter os seguintes valores:

none: indica que o usuário não necessitará consultar o áudio ou que o servidor quer minimizar seu tráfego; em outros termos indica que o áudio não deve ser pré-carregado;
metadata: indica que embora o usuário não necessitará consultar o áudio, pegar os meta-dados (ex: comprimento) é interessante;
auto: indica que o usuário necessita ter prioridade; em outros termos isso significa que, se necessário, o áudio inteiro pode ser baixado, mesmo que não seja esperado a execução;
Umastring vazia: é um sinônimo do valor auto.

Se não definido, seu valor padrão será definido pelo navegador (isto é, cada navegador pode escolher seu valor padrão), embora a especificação recomenda que seja definido para o metadata.

Note:Notas de uso:- O atributoautoplay tem precedência sobre opreload, pois se é necessário executar o áudio automaticamente, o navegador obviamente o baixará. Definindo ambosautoplay epreload é permitido pela especificação.
O navegador não é forçado pela especifição a seguir o valor desse atributo; é apenas uma sugestão.

src

A URL do áudio a ser incorporado. Isso é sujeito aHTTP access controls. Isto é opcional; ao invés disso você pode usar o elemento<source> dentro do bloco do áudio para especificar o vídeo a ser incorporado .

O tempo de compensação (time offset) entre o áudio e o vídeo está especificado como um valor de ponto flutuante (float) representando o número de segundos da compensação.

Nota:A definição de valor de tempo de compensação ainda não foi completada na especificação do HTML 5 e está sujeita a mudança.

Examples

html

<!-- Reprodução simples de áudio --><audio src="AudioTest.ogg" autoplay>  <a href="AudioTest.ogg" download="AudioTest.ogg">Baixar áudio OGG</a>.</audio><!-- Reprodução de áudio com legendas --><audio src="foo.ogg">  <track kind="captions" src="foo.en.vtt" srclang="en" label="English" />  <track kind="captions" src="foo.sv.vtt" srclang="sv" label="Svenska" /></audio>

Reproduz o arquivo de áudio anexado a esse artigo.