aboutsummaryrefslogtreecommitdiff
path: root/files/pt-br/web/html/element/audio
diff options
context:
space:
mode:
authorPeter Bengtsson <mail@peterbe.com>2020-12-08 14:42:52 -0500
committerPeter Bengtsson <mail@peterbe.com>2020-12-08 14:42:52 -0500
commit074785cea106179cb3305637055ab0a009ca74f2 (patch)
treee6ae371cccd642aa2b67f39752a2cdf1fd4eb040 /files/pt-br/web/html/element/audio
parentda78a9e329e272dedb2400b79a3bdeebff387d47 (diff)
downloadtranslated-content-074785cea106179cb3305637055ab0a009ca74f2.tar.gz
translated-content-074785cea106179cb3305637055ab0a009ca74f2.tar.bz2
translated-content-074785cea106179cb3305637055ab0a009ca74f2.zip
initial commit
Diffstat (limited to 'files/pt-br/web/html/element/audio')
-rw-r--r--files/pt-br/web/html/element/audio/index.html301
1 files changed, 301 insertions, 0 deletions
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
+---
+<h2 id="Sumário">Sumário</h2>
+
+<p>O elemento <code>audio</code> é utilizado para embutir conteúdo de som em um documento HTML ou XHTML.O elemento <code>audio</code> foi adicionado como parte do HTML5.</p>
+
+<p>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 <a href="/en-US/docs/Introducing_the_Audio_API_Extension" title="en-US/docs/Introducing the Audio API Extension">Introducing the audio API extension</a> para detalhes.</p>
+
+<h2 id="Contexto_de_Uso">Contexto de Uso</h2>
+
+<table class="standard-table">
+ <tbody>
+ <tr>
+ <td>Conteúdo permitido</td>
+ <td><a href="/en-US/docs/HTML/Content_categories#transparent_content" title="en-US/docs/HTML/Content categories#transparent content">Transparent content</a>, tanto um atributo <code>src</code> quanto um ou mais elementos {{ HTMLElement("source") }}, seguidos por um <a href="/en-US/docs/HTML/Content_categories#flow_content" title="en-US/docs/HTML/Content categories#flow content">flow content</a> ou <a href="/en-US/docs/HTML/Content_categories#phrasing_content" title="en-US/docs/HTML/Content categories#phrasing content">phrasing content</a>, sem{{ HTMLElement("video") }} ou elementos <code>&lt;audio&gt;</code>.</td>
+ </tr>
+ <tr>
+ <td>Omissão de tag</td>
+ <td>Nenhuma, tanto as tags iniciais quanto as finais devem estar presentes.</td>
+ </tr>
+ <tr>
+ <td>Elementos pai permitidos</td>
+ <td>Qualquer elemento que aceite <a href="/en-US/docs/HTML/Content_categories#flow_content" rel="internal">flow content</a>, ou qualquer elemento que aceite <a href="/en-US/docs/HTML/Content_categories#phrasing_content" rel="internal">phrasing content</a>.</td>
+ </tr>
+ <tr>
+ <td>Documento normativo</td>
+ <td><a class="external" href="http://www.w3.org/TR/html5/video.html#audio" title="http://www.w3.org/TR/html5/video.html#audio">HTML5, section 4.8.7</a></td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="Atributos">Atributos</h2>
+
+<p>Como todos os elementos HTML, este elemento suporta os <a href="/en-US/docs/HTML/Global_attributes" title="en-US/docs/HTML/Global attributes">global attributes</a>.</p>
+
+<dl>
+ <dt>{{ htmlattrdef("autoplay") }}</dt>
+ <dd>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.</dd>
+ <dt>{{ htmlattrdef("autobuffer") }} {{ obsolete_inline("2.0") }}</dt>
+ <dd>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 <code>preload</code>.</dd>
+ <dt>{{ htmlattrdef("buffered") }}</dt>
+ <dd>Um atributo que pode ser lido para determinar os intervalos do áudio que já foram carregados. Este atributo contém um objeto {{ domxref("TimeRanges") }}.</dd>
+ <dt>{{ htmlattrdef("controls") }}</dt>
+ <dd>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.</dd>
+ <dt>{{ htmlattrdef("loop") }}</dt>
+ <dd>Um atributo Booleano; se especificado, ao chegar no fim do áudio, ele voltará automaticamente para o começo.</dd>
+ <dt>{{ htmlattrdef("mozCurrentSampleOffset") }} {{ gecko_minversion_inline("2.0") }} {{ non-standard_inline() }}</dt>
+ <dd>The offset, specified as the number of samples since the beginning of the audio stream, at which the audio is currently playing.</dd>
+ <dt>{{ htmlattrdef("muted") }}</dt>
+ <dd>Um atributo Booleano que indica se o áudio será inicializado silenciado.</dd>
+ <dt>{{ htmlattrdef("played") }}</dt>
+ <dd>Um objeto {{ domxref("TimeRanges") }}indicando que todo o áudio foi reproduzido.</dd>
+ <dt>{{ htmlattrdef("preload") }}</dt>
+ <dd>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:
+ <ul>
+ <li><span style="font-family: Courier New;">none: </span>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;</li>
+ <li><span style="font-family: Courier New;">metadata</span>: indica que embora o usuário não necessitará consultar o áudio, pegar os meta-dados (ex: comprimento) é interessante;</li>
+ <li><span style="font-family: Courier New;">auto</span>: 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;</li>
+ <li>Uma <em>string vazia</em>: é um sinônimo do valor <span style="font-family: Courier New;">auto</span>.</li>
+ </ul>
+
+ <p>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 <span style="font-family: Courier New;">metadata</span>.</p>
+
+ <div class="note"><strong>Notas de uso:</strong>
+
+ <ul>
+ <li>O atributo <code>autoplay</code> tem precedência sobre o <code>preload,</code>pois se é necessário executar o áudio automaticamente, o navegador obviamente o baixará. Definindo ambos <code>autoplay</code> e <code>preload</code> é permitido pela especificação.</li>
+ <li>O navegador não é forçado pela especifição a seguir o valor desse atributo; é apenas uma sugestão.</li>
+ </ul>
+ </div>
+ </dd>
+ <dt>{{ htmlattrdef("src") }}</dt>
+ <dd>A URL do áudio a ser incorporado. Isso é sujeito a <a class="internal" href="/en-US/docs/HTTP_access_control" title="en-US/docs/HTTP access control">HTTP access controls</a>. Isto é opcional; ao invés disso você pode usar o elemento <code><a class="external" href="http://developer.mozilla.org/en-US/docs/pt-BR/HTML/Element/source">&lt;source&gt;</a></code> dentro do bloco do áudio para especificar o vídeo a ser incorporado .</dd>
+</dl>
+
+<p>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.</p>
+
+<div class="note"><strong>Nota:</strong> 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.</div>
+
+<h2 id="Examples">Examples</h2>
+
+<pre class="brush: html">&lt;!-- Reprodução simples de áudio --&gt;
+&lt;audio src="http://developer.mozilla.org/@api/deki/files/2926/=AudioTest_(1).ogg" autoplay&gt;
+ O seu navegador não suporta o elemento &lt;code&gt;audio&lt;/code&gt;.
+&lt;/audio&gt;
+
+&lt;!-- Reprodução de áudio com legendas --&gt;
+&lt;audio src="foo.ogg"&gt;
+ &lt;track kind="captions" src="foo.en.vtt" srclang="en" label="English"&gt;
+ &lt;track kind="captions" src="foo.sv.vtt" srclang="sv" label="Svenska"&gt;
+&lt;/audio&gt;
+</pre>
+
+<p>Reproduz o arquivo de áudio anexado a esse artigo.</p>
+
+<h2 id="Interface_do_DOM">Interface do DOM</h2>
+
+<ul>
+ <li><a href="/en-US/docs/DOM/HTMLAudioElement" title="en-US/docs/DOM/HTMLAudioElement">HTMLAudioElement</a></li>
+</ul>
+
+<h2 id="Compatibilidade_dos_Navegadores">Compatibilidade dos Navegadores</h2>
+
+<p>{{ CompatibilityTable() }}</p>
+
+<div id="compat-desktop">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th>Recurso</th>
+ <th>Chrome</th>
+ <th>Firefox (Gecko)</th>
+ <th>Internet Explorer</th>
+ <th>Opera</th>
+ <th>Safari</th>
+ </tr>
+ <tr>
+ <td>Suporte Básico</td>
+ <td>3.0</td>
+ <td>{{ CompatGeckoDesktop("1.9.1") }}</td>
+ <td>9.0</td>
+ <td>10.5</td>
+ <td>3.1</td>
+ </tr>
+ <tr>
+ <td>
+ <p>Atributo<code> autoplay</code></p>
+ </td>
+ <td>3.0</td>
+ <td>{{ CompatGeckoDesktop("1.9.1") }}</td>
+ <td>9.0</td>
+ <td>10.5</td>
+ <td>3.1</td>
+ </tr>
+ <tr>
+ <td>
+ <p>Atributo<code> buffered</code></p>
+ </td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatGeckoDesktop("2.0") }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ </tr>
+ <tr>
+ <td>Atributo <code>controls</code></td>
+ <td>3.0</td>
+ <td>{{ CompatGeckoDesktop("1.9.1") }}</td>
+ <td>9.0</td>
+ <td>10.5</td>
+ <td>3.1</td>
+ </tr>
+ <tr>
+ <td>Atributo <code>loop</code></td>
+ <td>3.0</td>
+ <td>{{ CompatGeckoDesktop("11.0") }}</td>
+ <td>9.0</td>
+ <td>10.5</td>
+ <td>3.1</td>
+ </tr>
+ <tr>
+ <td>Atributo <code>muted</code></td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatGeckoDesktop("11.0") }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ </tr>
+ <tr>
+ <td>Propriedade <code>played</code></td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatGeckoDesktop("15.0") }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ </tr>
+ <tr>
+ <td>Atributo<code> preload</code></td>
+ <td>3.0</td>
+ <td>{{ CompatGeckoDesktop("2.0") }}</td>
+ <td>9.0</td>
+ <td>Supported under the older name <code>autobuffer</code></td>
+ <td>3.1</td>
+ </tr>
+ <tr>
+ <td>Atributo <code>src</code></td>
+ <td>3.0</td>
+ <td>{{ CompatGeckoDesktop("1.9.1") }}</td>
+ <td>9.0</td>
+ <td>10.5</td>
+ <td>3.1</td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<div id="compat-mobile">
+<table class="compat-table">
+ <tbody>
+ <tr>
+ <th>Recurso</th>
+ <th>Android</th>
+ <th>Firefox Mobile (Gecko)</th>
+ <th>IE Mobile</th>
+ <th>Opera Mobile</th>
+ <th>Safari Mobile</th>
+ </tr>
+ <tr>
+ <td>Suporte Básico</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatGeckoMobile("1.0") }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ </tr>
+ <tr>
+ <td>Atributo <code>autoplay</code></td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatGeckoMobile("1.0") }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ </tr>
+ <tr>
+ <td>Atributo <code>buffered</code></td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatGeckoMobile("2.0") }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ </tr>
+ <tr>
+ <td>Atributo <code>controls</code></td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatGeckoMobile("1.0") }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ </tr>
+ <tr>
+ <td>Atributo <code>loop</code></td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatGeckoMobile("11.0") }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ </tr>
+ <tr>
+ <td>Atributo <code>muted</code></td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatGeckoMobile("11.0") }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ </tr>
+ <tr>
+ <td>Propriedade <code>played</code></td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatGeckoMobile("15.0") }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ </tr>
+ <tr>
+ <td>Atributo <code>preload</code></td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatGeckoMobile("2.0") }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ </tr>
+ <tr>
+ <td>Atributo <code>src</code></td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatGeckoMobile("1.0") }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ <td>{{ CompatUnknown() }}</td>
+ </tr>
+ </tbody>
+</table>
+</div>
+
+<div class="note"><strong>Nota:</strong> Para que o Gecko reproduza o áudio, o servidor deve disponibilizar o arquivo utilizando o tipo MIME correto.</div>
+
+<h2 id="Veja_também">Veja também</h2>
+
+<ul>
+ <li><a class="internal" href="/en-US/docs/Media_formats_supported_by_the_audio_and_video_elements" title="en-US/docs/Media formats supported by the audio and video elements">Media formats supported by the audio and video elements</a></li>
+ <li><a href="/en-US/docs/Introducing_the_Audio_API_Extension" title="en-US/docs/Introducing the Audio API Extension">Introducing the audio API extension</a></li>
+ <li><a href="/en-US/docs/DOM/HTMLAudioElement" title="en-US/docs/DOM/HTMLAudioElement"><code>HTMLAudioElement</code></a></li>
+ <li><a class="internal" href="/en-US/docs/XPCOM_Interface_Reference/NsIDOMHTMLMediaElement" title="en-US/docs/NsIDOMHTMLMediaElement"><code>nsIDOMHTMLMediaElement</code></a></li>
+ <li><a class="internal" href="http://developer-new.mozilla.org/pt-BR/docs/HTML/Element/Video" title="pt-BR/docs/HTML/Element/Video"><code>video</code></a></li>
+ <li><a class="internal" href="/en-US/docs/Using_HTML5_audio_and_video" title="en-US/docs/Using audio and video in Firefox">Using audio and video</a></li>
+ <li><a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/#audio" title="http://www.whatwg.org/specs/web-apps/current-work/#audio">The <code>audio</code> element</a> (Especificação HTML5)</li>
+</ul>
+
+<p></p>