audio

Introduced in HTML5

Sumário

O elemento audio é utilizado para embutir conteúdo de som em um documento HTML ou XHTML.O elemento audio 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 flixo de áudio a partir do código JavaScript. Veja Introducing 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 um flow content ou phrasing 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 aceite flow content, ou qualquer elemento que aceite phrasing content.
Documento normativo HTML5, section 4.8.7

Atributos

Como todos os elementos HTML, este elemento suporta os global 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 Obsolete since Gecko 2.0
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 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1) em razão do atributo preload.
buffered
Um atributo que pode ser lido para determinar os intervalos do áudio que já foram carregados. Este atributo contém um objeto TimeRanges.
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.
mozCurrentSampleOffset
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 objeto TimeRangesindicando 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;
  • Uma string 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.

Notas de uso:
  • O atributo autoplay tem precedência sobre o preload,pois se é necessário executar o áudio automaticamente, o navegador obviamente o baixará. Definindo ambos autoplay e preload é 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 a HTTP 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

<!-- Reprodução simples de áudio -->
<audio src="http://developer.mozilla.org/@api/deki/files/2926/=AudioTest_(1).ogg" autoplay>
  O seu navegador não suporta o elemento <code>audio</code>.
</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.

Interface do DOM

Compatibilidade dos Navegadores

Recurso Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte Básico 3.0 3.5 (1.9.1) 9.0 10.5 3.1

Atributo autoplay

3.0 3.5 (1.9.1) 9.0 10.5 3.1

Atributo buffered

? 4.0 (2.0) ? ? ?
Atributo controls 3.0 3.5 (1.9.1) 9.0 10.5 3.1
Atributo loop 3.0 11.0 (11.0) 9.0 10.5 3.1
Atributo muted ? 11.0 (11.0) ? ? ?
Propriedade played ? 15.0 (15.0) ? ? ?
Atributo preload 3.0 4.0 (2.0) 9.0 Supported under the older name autobuffer 3.1
Atributo src 3.0 3.5 (1.9.1) 9.0 10.5 3.1
Recurso Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suporte Básico ? 1.0 (1.0) ? ? ?
Atributo autoplay ? 1.0 (1.0) ? ? ?
Atributo buffered ? 4.0 (2.0) ? ? ?
Atributo controls ? 1.0 (1.0) ? ? ?
Atributo loop ? 11.0 (11.0) ? ? ?
Atributo muted ? 11.0 (11.0) ? ? ?
Propriedade played ? 15.0 (15.0) ? ? ?
Atributo preload ? 4.0 (2.0) ? ? ?
Atributo src ? 1.0 (1.0) ? ? ?
Nota: Para que o Gecko reproduza o áudio, o servidor deve disponibilizar o arquivo utilizando o tipo MIME correto.

Veja também

Anexos

Arquivo Tamanho Data Anexado por
AudioTest (1).ogg
42324 bytes 2008-10-09 19:50:31 Sheppy
Zapfino.svg
1399728 bytes 2009-12-25 15:15:25 andydude

Document Tags and Contributors

Contributors to this page: LeonardoPacheco, mateus.m.luna
Última atualização por: mateus.m.luna,