From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- files/pt-br/web/html/element/audio/index.html | 301 ++++++++++++++++++++++++++ 1 file changed, 301 insertions(+) create mode 100644 files/pt-br/web/html/element/audio/index.html (limited to 'files/pt-br/web/html/element/audio/index.html') diff --git a/files/pt-br/web/html/element/audio/index.html b/files/pt-br/web/html/element/audio/index.html new file mode 100644 index 0000000000..24b982c0ca --- /dev/null +++ b/files/pt-br/web/html/element/audio/index.html @@ -0,0 +1,301 @@ +--- +title: audio +slug: Web/HTML/Element/Audio +translation_of: Web/HTML/Element/audio +--- +

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 fluxo de áudio a partir do código JavaScript. Veja Introducing the audio API extension para detalhes.

+ +

Contexto de Uso

+ + + + + + + + + + + + + + + + + + + + +
Conteúdo permitidoTransparent content, tanto um atributo src quanto um ou mais elementos {{ HTMLElement("source") }}, seguidos por um flow content ou phrasing content, sem{{ HTMLElement("video") }} ou elementos <audio>.
Omissão de tagNenhuma, tanto as tags iniciais quanto as finais devem estar presentes.
Elementos pai permitidosQualquer elemento que aceite flow content, ou qualquer elemento que aceite phrasing content.
Documento normativoHTML5, section 4.8.7
+ +

Atributos

+ +

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

+ +
+
{{ htmlattrdef("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.
+
{{ htmlattrdef("autobuffer") }} {{ obsolete_inline("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 {{ geckoRelease("2.0") }} em razão do atributo preload.
+
{{ htmlattrdef("buffered") }}
+
Um atributo que pode ser lido para determinar os intervalos do áudio que já foram carregados. Este atributo contém um objeto {{ domxref("TimeRanges") }}.
+
{{ htmlattrdef("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.
+
{{ htmlattrdef("loop") }}
+
Um atributo Booleano; se especificado, ao chegar no fim do áudio, ele voltará automaticamente para o começo.
+
{{ htmlattrdef("mozCurrentSampleOffset") }} {{ gecko_minversion_inline("2.0") }} {{ non-standard_inline() }}
+
The offset, specified as the number of samples since the beginning of the audio stream, at which the audio is currently playing.
+
{{ htmlattrdef("muted") }}
+
Um atributo Booleano que indica se o áudio será inicializado silenciado.
+
{{ htmlattrdef("played") }}
+
Um objeto {{ domxref("TimeRanges") }}indicando que todo o áudio foi reproduzido.
+
{{ htmlattrdef("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.
    • +
+
+
+
{{ htmlattrdef("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

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
RecursoChromeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte Básico3.0{{ CompatGeckoDesktop("1.9.1") }}9.010.53.1
+

Atributo autoplay

+ 		3.0{{ CompatGeckoDesktop("1.9.1") }}9.010.53.1
+

Atributo buffered

+ 		{{ CompatUnknown() }}{{ CompatGeckoDesktop("2.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
Atributo controls3.0{{ CompatGeckoDesktop("1.9.1") }}9.010.53.1
Atributo loop3.0{{ CompatGeckoDesktop("11.0") }}9.010.53.1
Atributo muted{{ CompatUnknown() }}{{ CompatGeckoDesktop("11.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
Propriedade played{{ CompatUnknown() }}{{ CompatGeckoDesktop("15.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
Atributo preload3.0{{ CompatGeckoDesktop("2.0") }}9.0Supported under the older name autobuffer3.1
Atributo src3.0{{ CompatGeckoDesktop("1.9.1") }}9.010.53.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
RecursoAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Suporte Básico{{ CompatUnknown() }}{{ CompatGeckoMobile("1.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
Atributo autoplay{{ CompatUnknown() }}{{ CompatGeckoMobile("1.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
Atributo buffered{{ CompatUnknown() }}{{ CompatGeckoMobile("2.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
Atributo controls{{ CompatUnknown() }}{{ CompatGeckoMobile("1.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
Atributo loop{{ CompatUnknown() }}{{ CompatGeckoMobile("11.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
Atributo muted{{ CompatUnknown() }}{{ CompatGeckoMobile("11.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
Propriedade played{{ CompatUnknown() }}{{ CompatGeckoMobile("15.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
Atributo preload{{ CompatUnknown() }}{{ CompatGeckoMobile("2.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
Atributo src{{ CompatUnknown() }}{{ CompatGeckoMobile("1.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
+
+ +
Nota: Para que o Gecko reproduza o áudio, o servidor deve disponibilizar o arquivo utilizando o tipo MIME correto.
+ +

Veja também

+ + + +

-- cgit v1.2.3-54-g00ecf