path: root/files/ca/web/html/element/audio/index.html

---
title: <audio>
slug: Web/HTML/Element/audio
tags:
  - Element
  - HTML
  - HTML contingut inserit
  - HTML5
  - Media
  - Multimedia
  - Referencia
  - Web
translation_of: Web/HTML/Element/audio
---
<h2 id="Sumari">Sumari</h2>

<p class="summary"><span id="result_box" lang="ca"><span>L'element</span> <span>HTML</span> <span>&lt;</span><span>àudio</span><span>&gt;</span> <span>s'utilitza</span> <span>per inserir</span> <span>contingut</span> <span>de so</span> <span>en els</span> <span>documents.</span> <span>Pot contenir</span> <span>una o més</span> <span>fonts</span> <span>d'àudio,</span> <span>representat</span> <span>mitjançant l'atribut</span> <span>src</span> <span>o</span> <span>l'element</span> </span><span class="seoSummary">{{HTMLElement("source")}}</span><span lang="ca"> <span>el navegador</span> <span>va a triar el</span> <span>més</span> <span>adequat.</span></span></p>

<p>El contingut alternatiu per als navegadors que no suporten l'element &lt;àudio&gt; es pot també afegir, dins de l'obertura i tancament de les etiquetes <code>&lt;audio&gt;&lt;/audio&gt;</code>.</p>

<p>La funcionalitat de reproducció més bàsica pot posar-se a disposició mitjançant l'atribut controls (vegeu més endavant); per a un ús més avançat, la reproducció d'àudio i els controls poden ser manipulats mitjançant l'HTML Media API, i més específicament les característiques definides a la interfície {{domxref("HTMLAudioElement")}}.</p>

<p>També pot utilitzar la Web Audio API per generar i manipular directament els fluxos d'àudio des de codi JavaScript. Veure <a href="/en-US/docs/Web/API/Web_Audio_API">Web Audio API</a> per a més detalls.</p>

<h2 id="Context_d'us">Context d'us</h2>

<ul>
 <li>Contingut permès: Si l'element té un atribut {{htmlattrxref("src", "audio")}}: amb zero o més elements {{HTMLElement("track")}}, seguits pel contingut transparent que no conté elements multmèdia - és a dir, sense elements {{HTMLElement("audio")}} o {{HTMLElement("video")}}.</li>
 <li>O bé: amb zero o més elements {{HTMLElement("source")}}, seguit de zero o més elements {{HTMLElement("track")}}, seguit pel contingut transparent que no conté elements multimedia,és a dir, sense elements {{HTMLElement("audio")}} o {{HTMLElement("video")}}.</li>
</ul>

<table class="properties">
 <tbody>
  <tr>
   <th scope="row"><a href="/en-US/docs/Web/HTML/Content_categories">Categories de contingut</a></th>
   <td><a href="/en-US/docs/Web/HTML/Content_categories#Flow_content">Contingut de Flux</a>, phrasing content, contingut incrustat. Si té un atribut {{htmlattrxref("controls", "audio")}}: contingut interactiu i contingut palpable.</td>
  </tr>
  <tr>
   <th scope="row">Contingut permès</th>
   <td>Si l'element té un atribut {{htmlattrxref("src", "audio")}}: zero o més elements {{HTMLElement("track")}} seguit de contingut transparent que no conté elements mèdia, que no és {{HTMLElement("audio")}} o {{HTMLElement("video")}}<br>
    O bé: zero o més elements {{HTMLElement("source")}}, seguit de zero o més elements {{HTMLElement("track")}}, seguit de contingut transparent que no conté elements mèdia, és a dir sense {{HTMLElement("audio")}} o {{HTMLElement("video")}}.</td>
  </tr>
  <tr>
   <th scope="row">Omissió de l'etiqueta</th>
   <td>{{no_tag_omission}}</td>
  </tr>
  <tr>
   <th scope="row">Elements pares permesos</th>
   <td><span class="short_text" id="result_box" lang="ca"><span>Qualsevol</span> <span>element</span> <span>que accepti</span> <span>contingut</span> <span>incrustat</span></span> .</td>
  </tr>
  <tr>
   <th scope="row">Interfície DOM</th>
   <td>{{domxref("HTMLAudioElement")}}</td>
  </tr>
 </tbody>
</table>

<h2 id="Atributs">Atributs</h2>

<p><span class="short_text" id="result_box" lang="ca"><span>Aquest</span> <span>element</span> <span>inclou el</span></span>s <span style="line-height: 21px;"> </span><a href="/en-US/docs/Web/HTML/Global_attributes">gatributs globals</a>.</p>

<dl>
 <dt>{{htmlattrdef("autoplay")}}</dt>
 <dd>Atribut Booleà; si s'especifica (fins i tot si el valor és "fals"!), l'àudio iniciarà automàticament la reproducció tan aviat com pugui fer-ho, sense esperar que l'arxiu d'àudio complet s'hagi acabat de descarregar.</dd>
 <dt>{{htmlattrdef("autobuffer")}} {{obsolete_inline("2.0")}}</dt>
 <dd>Atribut booleà; si s'especifica, s'iniciarà automàticament la descàrrega del àudio, fins i tot si no s'ha establert la reproducció automàtica. Això continua fins que la memòria cau multimèdia està plena, o tot l'arxiu d'àudio s'hagi descarregat, el que passi primer. Això només s'ha d'utilitzar quan s'espera que l'usuari esculli per reproduir l'àudio; per exemple, si l'usuari ha navegat a una pàgina mitjançant un enllaç "Reproduir aquest àudio". Aquest atribut es va eliminar al Gecko 2.0 {{geckoRelease ("2,0")}} en favor de l'atribut preload</dd>
 <dt>{{htmlattrdef("buffered")}}</dt>
 <dd>Un atribut que pot llegir per a veure els intervals de temps del media que han estat emmagatzemades en el buffer. Aquest atribut conté un objecte {{domxref("TimeRanges")}}.</dd>
 <dt>{{htmlattrdef("controls")}}</dt>
 <dd>Si aquest atribut és present, el navegador ofereix controls per permetre a l'usuari controlar la reproducció d'àudio, incloent el volum, recerca i pausa/reprendre la reproducció.</dd>
 <dt>{{htmlattrdef("loop")}}</dt>
 <dd>Atribut booleà; si s'especifica, buscarà automàticament de nou al començament en arribar al final de l'àudio.</dd>
 <dt>{{htmlattrdef("mozCurrentSampleOffset")}} {{gecko_minversion_inline("2.0")}} {{non-standard_inline}}</dt>
 <dd>El desplaçament, especificat com el nombre de mostres des del començament de la seqüència d'àudio, en el qual l'àudio s'està reproduint.</dd>
 <dt>{{htmlattrdef("muted")}}</dt>
 <dd>Atribut booleà que indica si l'àudio serà silenciat inicialment. El seu valor per defecte és fals.</dd>
 <dt>{{htmlattrdef("played")}}</dt>
 <dd>Un objecte {{domxref("TimeRanges")}} indicant totes les gammes d'àudio que s'han reproduït.</dd>
 <dt>{{htmlattrdef("preload")}}</dt>
 <dd>Aquest atribut enumerat està destinat a proporcionar un suggeriment al navegador sobre el que l'autor pensa en que el pot conduir a una millor experiència d'usuari. Pot tenir un dels següents valors:
 <ul>
  <li><code>none</code>: indica que l'àudio no ha de ser precarregat;</li>
  <li><code>metadata</code>: indica que unicament es recupera les metadata d'àudio (per exemple, longitud);</li>
  <li><code>auto</code>: indica que el fitxer d'àudio podria ser descarregat sencer, encara que no s'espera que l'usuari ho utilitzi;</li>
  <li>la <em>cadena buida</em>: sinònim del valor <code>auto</code>.</li>
 </ul>

 <p>Si no s'estableix el valor predeterminat és definit pel propi navegador (és a dir, cada navegador pot tenir el seu propi valor per omissió). L'especificació informa que s'estableixi en les <code>metadata</code>.</p>

 <div class="note"><strong>Notes d'ús:</strong>

 <ul>
  <li>L'atribut <code>autoplay</code> té prioritat sobre l'atribut <code>preload.</code>Si s'especifica <code>autoplay</code>, el navegador hauria de començar, òbviament, a descarregar l'àudio per a la seva reproducció.</li>
  <li><span id="result_box" lang="ca"><span>El navegador</span> <span>no</span> <span>és</span> <span>forçat</span> <span>per l'especificació</span> <span>a seguir el</span> <span>valor d'aquest</span> <span>atribut</span><span>;</span> <span>és</span> <span>un mer suggeriment</span><span>.</span></span></li>
 </ul>
 </div>
 </dd>
 <dt>{{htmlattrdef("src")}}</dt>
 <dd>La direcció URL de l'àudio a inserir. Està subjecte als <a href="/en-US/docs/HTTP_access_control">controls d'access HTTP</a>. És opcional; en el seu lloc podeu utilitzar el element {{htmlelement("source")}} dins del bloc d'àudio per especificar l'àudio a encastar.</dd>
 <dt>{{htmlattrdef("volume")}}</dt>
 <dd>El volum de reproducció, va del rang 0.0 (silenci) a 1.0 (el més alt).</dd>
</dl>

<p>Els desplaçaments de temps s'especifiquen com a valors de coma flotant que indica el nombre de segons per compensar.</p>

<div class="note"><strong>Note:</strong> El valor de definició de desplaçament del temps encara no s'ha completat en l'especificació HTML5 i està subjecte a canvis.</div>

<h2 id="Events">Events</h2>

<p><span id="result_box" lang="ca"><span>Un element</span> <span>audio</span> <span>pot disparar</span> <span>diversos</span> </span><a href="/en-US/docs/Web/Guide/Events/Media_events">events</a>.</p>

<h2 id="Exemples">Exemples</h2>

<h3 id="Us_bàsic">Us bàsic</h3>

<pre class="brush: html">&lt;!-- Simple audio playback --&gt;
&lt;audio src="http://developer.mozilla.org/@api/deki/files/2926/=AudioTest_(1).ogg" autoplay&gt;
  Your browser does not support the &lt;code&gt;audio&lt;/code&gt; element.
&lt;/audio&gt;

&lt;!-- Audio playback with captions --&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>

<h3 id="Element_audio_amb_l'element_source">E<span class="short_text" id="result_box" lang="ca"><span>lement</span> <span>audio</span> <span>amb l'element</span> source</span></h3>

<pre class="brush: html">&lt;audio controls="controls"&gt;
  Your browser does not support the &lt;code&gt;audio&lt;/code&gt; element.
  &lt;source src="foo.wav" type="audio/wav"&gt;
&lt;/audio&gt;
</pre>

<h2 id="Specifications" name="Specifications">Especificacions</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Especificació</th>
   <th scope="col">Estat</th>
   <th scope="col">Comentari</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('HTML WHATWG', 'the-video-element.html#the-audio-element', '&lt;audio&gt;')}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td> </td>
  </tr>
  <tr>
   <td>{{SpecName('HTML5 W3C', 'embedded-content-0.html#the-audio-element', '&lt;audio&gt;')}}</td>
   <td>{{Spec2('HTML5 W3C')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>

<h2 id="Navegadors_compatibles">Navegadors compatibles</h2>

<div>{{CompatibilityTable}}</div>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Característica</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>3.0</td>
   <td>{{CompatGeckoDesktop("1.9.1")}} [1]</td>
   <td>9.0</td>
   <td>10.5</td>
   <td>3.1</td>
  </tr>
  <tr>
   <td>atribut <code>autoplay</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>atribut <code>buffered</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoDesktop("2.0")}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td>atribut <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>atribut <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>atribut <code>muted</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoDesktop("11.0")}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td><code>propietat played</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoDesktop("15.0")}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td>atribut <code>preload</code></td>
   <td>3.0</td>
   <td>{{CompatGeckoDesktop("2.0")}}</td>
   <td>9.0</td>
   <td>{{CompatVersionUnknown}} [2]</td>
   <td>3.1</td>
  </tr>
  <tr>
   <td>atribut <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>
  <tr>
   <td>atribut volume</td>
   <td> </td>
   <td> </td>
   <td> </td>
   <td> </td>
   <td> </td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Característica</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Suport bàsic</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoMobile("1.0")}} [1]</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td>atribut <code>autoplay</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoMobile("1.0")}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td>atribut <code>buffered</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoMobile("2.0")}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td>atribut <code>controls</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoMobile("1.0")}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td>atribut <code>loop</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoMobile("11.0")}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td>atribut <code>muted</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoMobile("11.0")}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td><code>propietat played</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoMobile("15.0")}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td>atribut <code>preload</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoMobile("2.0")}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td>atribut <code>src</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoMobile("1.0")}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td>atribut <code>volume</code></td>
   <td> </td>
   <td> </td>
   <td> </td>
   <td> </td>
   <td> </td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] <span id="result_box" lang="ca"><span>Per</span> <span>Gecko,</span> <span>per reproduir</span> <span>l'àudio</span><span>, el servidor</span> <span>ha de servir</span> <span>l'arxiu amb</span> <span>el tipus</span> <span>MIME</span> <span>correcte.</span></span></p>

<p>[2]  <span id="result_box" lang="ca"><span>S</span><span>uportat</span> <span>sota</span> <span>el antic </span></span><span lang="ca"><span>nom</span> <code><span>autobuffer</span></code></span></p>

<h2 id="Veure">Veure</h2>

<ul>
 <li><a href="/en-US/docs/Media_formats_supported_by_the_audio_and_video_elements">Formats media suportats pels elements audio i video</a></li>
 <li><a href="/en-US/docs/Web_Audio_API">Web Audio API</a></li>
 <li>{{domxref("HTMLAudioElement")}}</li>
 <li><a href="/en-US/docs/XPCOM_Interface_Reference/NsIDOMHTMLMediaElement"><code>nsIDOMHTMLMediaElement</code></a></li>
 <li>{{htmlelement("source")}}</li>
 <li>{{htmlelement("video")}}</li>
 <li><a href="/en-US/docs/Using_HTML5_audio_and_video">L'ús d'àudio i vídeo</a></li>
 <li><a href="http://www.whatwg.org/specs/web-apps/current-work/#audio">El element <code>audio</code></a> (HTML5 specification)</li>
</ul>

<p>{{HTMLRef}}</p>