Esta página ha sido traducida del inglés por la comunidad.Aprende más y únete a la comunidad de MDN Web Docs.
Audio
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.
* Some parts of this feature may have varying levels of support.
El elementoaudio se usa para insertar contenido de audio en un documento HTML o XHTML. El elementoaudio se agregó como parte de HTML 5.
Nota:Actualmente Gecko admite solamente Vorbis, en contenedores Ogg, así como formato WAV. Asimismo, el servidor debe servir el archivo mediante el tipo MIME correcto con el fin de que Gecko lo reproduzca correctamente.
Puedes usar las características API de audio mejoradas - que son específicas de Gecko - para generar y manipular directamente secuencias de audio a partir de código JavaScript. ConsultaManipular sonido a través de la API de audio mejorada para tener más detalles.
Contexto de uso
| Contenido permitido | Contenido transparente, que contiene bien un atributosrc, bien uno o más elementos<source>, seguido decontenido dinámico ocontenido estático , sin ningún elemento de<video> o<audio>. |
|---|---|
| Omisión de etiquetas | Ninguna, deben estar presentes tanto las etiquetas de inicio como las de cierre. |
| Elementos primarios permitidos | Cualquier elemento que aceptecontenido dinámico o cualquier elemento que aceptecontenido estático. |
| Documento normativo | HTML5, sección 4.8.7 |
Atributos
- autoplay
Un atributo booleano; si se especifica (incluso aunque el valor sea "false"), el sonido comenzará a reproducirse automáticamente en cuanto sea posible, sin detenerse para terminar de cargar los datos.
- autobufferObsoleto
Un atributo booleano; si se especifica, el sonido comenzará a reproducirse automáticamente, incluso aunque no se haya configurado para la reproducción automática. Esto continuará hasta que la caché de medios esté llena o se haya descargado el archivo de audio completo, lo que suceda primero. Debería usarse sólo si se espera que el usuario elija reproducir el audio; por ejemplo si el usuario ha navegado hasta una página usando un vínculo de "Reproducir este audio". Este atributo se eliminó de Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1) en favor del atributo preload.
- buffered
Un atributo que se puede leer para determinar qué intervalos de tiempo del multimedia se han almacenado en búfer. Este atributo contiene un objeto
TimeRanges.- controls
Si está presente este atributo, el navegador ofrecerá controles para permitir que el usuario controle la reproducción de audio, incluyendo volumen, búsqueda y pausar/reanudar reproducción.
- loopError 449157 en Firefox
Un atributo booleano; si se especifica, al alcanzar el final del audio, realizaremos la búsqueda automáticamente hasta el principio.
- mozCurrentSampleOffsetNo estándar
La posición de desplazamiento, que se especifica como el número de muestras desde el comienzo de la secuencia de audio, en la cual el audio se está reproduciendo actualmente.
- preloadError 548523 en Firefox
El objetivo de este atributo enumerado es proporcionar una sugerencia al navegador sobre qué cree el autor que proporcionará la mejor experiencia para el usuario . Puede tener uno de los siguientes valores:
none: sugiere bien que el autor cree que el usuario no tendrá que consultar ese video, bien que el servidor desea minimizar su tráfico; es decir, esta sugerencia indica que no se debe almacenar en caché este video;metadata: sugiere que aunque el autor piensa que el usuario no tendrá que consultar ese video, es razonable capturar los metadatos (p. ej. longitud);auto: sugiere que el usuario necesita tener prioridad; es decir, esta sugerencia indica que, si es necesario, se puede descargar el video completo, incluso aunque el usuario no vaya a usarlo;- theempty string: que es sinónimo del valor
auto.
Si no está configurado, su valor predeterminado está definido por el navegador (es decir, cada navegador puede elegir su propio valor predeterminado), aunque la especificación aconseje que se establezca ametadatos.
Nota:Observaciones sobre uso:
- El atributoautoplay tiene prioridad sobre éste puesto que si se desea reproducir automáticamente un video, el navegador obviamente tendrá que descargarlo. La especificación permite establecer los atributosautoplay ypreload.
- La especificación no fuerza al navegador a seguir el valor de este atributo; es tan sólo una sugerencia.
- src
La URL del audio que se va a insertar. Está sujeta a losControles de acceso HTTP. Es opcional; en su lugar puedes usar el elemento
sourcedentro del bloque de audio para especificar el audio que se va a insertar.
Las compensaciones de tiempo se especifican como valores float que indican el número de segundos que se va a compensar.
Nota:La definición del valor de compensación de tiempo no se ha completado en HTML 5 aún y está sujeta a cambios.
Ejemplos
<audio src="audiotest_(1).ogg" autoplay> Your browser does not support the <code>audio</code> element.</audio>Reproduce el fichero de audio adjunto a este artículo.