Inicio rápido: agregar audio a una aplicación (HTML)
[ Este artículo está destinado a desarrolladores de Windows 8.x y Windows Phone 8.x que escriben aplicaciones de Windows Runtime. Si estás desarrollando para Windows 10, consulta la documentación más reciente ]
En este tema se explican las categorías de transmisión de secuencias de audio y se indica cómo usar la etiqueta <audio> para agregar funcionalidades de transmisión de secuencias de audio a tu aplicación.
Windows 8 ha proporcionado una plataforma que facilita relativamente el uso de HTML5 para agregar funcionalidades de transmisión por secuencias de audio a una aplicación de la Tienda Windows.
La etiqueta de audio tiene los siguientes atributos:
| Atributo | Valores permitidos | Descripción |
|---|---|---|
| autoplay | autoplay | Especifica que el audio comenzará a reproducirse en cuanto esté listo |
| controls | controls | Especifica que deben mostrarse los controles de audio (por ejemplo, un botón Repr/Pausa, entre otros) |
| loop | loop | Especifica que el audio volverá a comenzar cada vez que finalice |
| preload | auto metadata none |
Especifica si el autor considera que el audio debe cargarse al cargar la página y de qué manera |
| src | <ruta de acceso del archivo> | Especifica la ruta de acceso del archivo de audio |
Microsoft proporciona un atributo adicional, msAudioCategory, que puedes usar para mejorar el comportamiento de la aplicación compatible con audio. En la siguiente tabla se muestran los valores permitidos para este atributo y unas descripciones breves de lo que hacen.
| Categoría de transmisión en secuencias | Descripción | ¿Se ejecuta en segundo plano? |
|---|---|---|
| Alert | Sonidos de alerta sobre repeticiones y ejecuciones largas:
|
No |
| BackgroundCapableMedia | Para audio que necesita continuar reproduciéndose en segundo plano. Algunos ejemplos incluyen los siguientes escenarios de reproducción de multimedia local:
|
Sí |
| Communications | Para audio de comunicaciones de transmisión en secuencias, como los siguientes:
|
Sí |
| ForeGroundOnlyMedia | Juegos u otros sonidos diseñados para funcionar solamente en primer plano, que silenciarán los sonidos multimedia en segundo plano existentes.
|
No |
| GameEffects | Efectos de sonido de juegos diseñados para combinarse con el audio existente
|
No |
| GameMedia | Música de segundo plano que reproduce un juego | No |
| SoundEffects | Efectos de sonido o juegos diseñados para combinarse con el audio existente:
|
No |
| Other | Tipo de audio predeterminado y recomendado para todos los medios de audio que no necesitan continuar reproduciéndose en segundo plano. | No |
Objetivo: Para agregar funcionalidades de audio a una aplicación de la Tienda Windows mediante el método más sencillo
Requisitos previos
Debes estar familiarizado con el control de eventos y eventos de Windows, JavaScript y HTML.
Debes tener un reproductor multimedia instalado que pueda reproducir MPEG-Layer 3 (MP3) u otros archivos digitales de música.
Tiempo para finalizar: 15 minutos.
Instrucciones
Adición de audio con la etiqueta <audio>
Al agregar la etiqueta <audio>, debes usar el atributo "controls" para indicar que deseas que se muestren los controles (los botones). En el siguiente paso se muestra cómo realizar esta tarea.
Copia y pega el siguiente código en la ubicación del archivo HTML donde deseas que se muestren los controles de audio:
// Adding the <audio> tag to your app <audio controls="controls"> <source src="song.mp3"/> </audio>
Adición del atributo msAudioCategory
Al agregar el atributo msAudioCategory a la etiqueta <audio> proporcionas más funcionalidad. El atributo msAudioCategory asociará ciertos comportamientos mejorados con la etiqueta de audio, lo cual mejorará la experiencia del usuario con la aplicación. En el siguiente paso se muestra cómo agregar el atributo msAudioCategory.
Agrega el atributo msAudioCategory dentro de la etiqueta <audio>, como se muestra a continuación:
// Enhancing behavior of audio tag // with the msAudioCategory attribute <audio msAudioCategory="BackgroundCapableMedia" controls="controls"> <source src="song.mp3"/> </audio>
Resumen y siguientes pasos
Es importante que pienses cuidadosamente sobre la categoría que vas a seleccionar para la secuencia, ya que la aplicación se comportará de forma distinta en cada caso.
En el siguiente tema sobre cómo configurar teclas para controles multimedia, se muestra cómo agregar y configurar botones multimedia para la aplicación de la Tienda Windows. Después puedes usar estos botones para reproducir, pausar, detener o incluso avanzar rápidamente una secuencia de audio.
Temas relacionados
Cómo configurar teclas para controles multimedia