diff options
Diffstat (limited to 'files/ca/web/html/element/audio/index.html')
| -rw-r--r-- | files/ca/web/html/element/audio/index.html | 371 |
1 files changed, 371 insertions, 0 deletions
diff --git a/files/ca/web/html/element/audio/index.html b/files/ca/web/html/element/audio/index.html new file mode 100644 index 0000000000..ec8e3f81ee --- /dev/null +++ b/files/ca/web/html/element/audio/index.html @@ -0,0 +1,371 @@ +--- +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><</span><span>àudio</span><span>></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 <àudio> es pot també afegir, dins de l'obertura i tancament de les etiquetes <code><audio></audio></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"><!-- Simple audio playback --> +<audio src="http://developer.mozilla.org/@api/deki/files/2926/=AudioTest_(1).ogg" autoplay> + Your browser does not support the <code>audio</code> element. +</audio> + +<!-- Audio playback with captions --> +<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> +</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"><audio controls="controls"> + Your browser does not support the <code>audio</code> element. + <source src="foo.wav" type="audio/wav"> +</audio> +</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', '<audio>')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('HTML5 W3C', 'embedded-content-0.html#the-audio-element', '<audio>')}}</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> |