Démarrage rapide : ajout d’éléments audio à une application (HTML)
[ Cet article est destiné aux développeurs Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]
Cette rubrique explique les catégories de flux audio et montre comment utiliser la balise <audio> pour ajouter des fonctionnalités de diffusion audio en continu à votre application.
Windows 8 fournit une plateforme qui facilite grandement l’utilisation du langage HTML5 pour ajouter à une application du Windows Store des fonctionnalités de diffusion audio en continu.
La balise audio possède les attributs suivants :
Attribut | Valeurs autorisées | Description |
---|---|---|
autoplay | autoplay | Spécifie que le son commencera sa lecture dès qu’il sera prêt. |
controls | controls | Spécifie que les contrôles audio soient affichés (comme un bouton lire/pause). |
loop | loop | Spécifie que le son redémarrera chaque fois qu’il arrivera à la fin. |
preload | auto metadata none |
Spécifie si et comment l’auteur pense que le son doive être chargé au chargement de la page. |
src | <chemin d’accès du fichier> | Spécifie le chemin d’accès du fichier audio. |
Microsoft fournit un attribut supplémentaire, msAudioCategory, que vous pouvez utiliser pour améliorer le comportement de votre application à prise en charge audio. Le tableau suivant montre les valeurs autorisées de cet attribut, et de brèves descriptions de ce qu’elles font.
Catégorie de flux | Description | Prise en charge de la lecture en arrière-plan |
---|---|---|
Alert | Sons d’alerte en boucle ou à exécution longue :
|
Non |
BackgroundCapableMedia | Pour l’animation sonore qui doit continuer à se jouer en arrière-plan. Les scénarios de lecture de média locaux suivants en sont des exemples :
|
Oui |
Communications | Pour du son de communication en streaming comme :
|
Oui |
ForeGroundOnlyMedia | Jeux ou autres sons conçus uniquement pour fonctionner en premier plan, mais qui coupent les sons de médias en arrière-plan existants.
|
Non |
GameEffects | Effets sonores de jeu conçus pour se mélanger à des sons existants
|
Non |
GameMedia | Musique d’arrière-plan jouée par un jeu | Non |
SoundEffects | Jeu ou autre effet sonore conçu pour se mélanger à des sons existants :
|
Non |
Other | Type audio par défaut, et recommandé pour tous les médias audio qui n’ont pas besoin de continuer à se lire en arrière-plan. | Non |
Objectif: Pour ajouter des capacités audio à une application du Windows Store à l’aide de la méthode la plus simple
Prérequis
Vous devez connaître le code HTML, le langage JavaScript, les événements Windows et la gestion des événements.
Vous devez avoir un lecteur multimédia installé capable de lire des fichiers MP3 (MPEG-Layer 3) ou d’autres fichiers musicaux numériques.
Durée de réalisation: 15 minutes.
Instructions
Ajout d’audio avec la balise <audio>
Lorsque vous ajoutez la balise <audio>, vous devez utiliser l’attribut « controls » pour indiquer que vous voulez que les contrôles (les boutons) soient affichés. L’étape suivante montre comment procéder.
Copiez et collez le code suivant à l’emplacement de votre fichier HTML où vous voulez que les contrôles audio soient affichés :
// Adding the <audio> tag to your app <audio controls="controls"> <source src="song.mp3"/> </audio>
Ajout de l’attribut msAudioCategory
Lorsque vous ajoutez l’attribut msAudioCategory à votre balise <audio>, vous fournissez plus de fonctionnalité. L’attribut msAudioCategory associera certains comportements développés à votre balise audio, et améliorera l’expérience de l’utilisateur avec votre application. L’étape suivante montre comment ajouter l’attribut msAudioCategory.
Ajoutez l’attribut msAudioCategory dans la balise <audio> comme suit :
// Enhancing behavior of audio tag // with the msAudioCategory attribute <audio msAudioCategory="BackgroundCapableMedia" controls="controls"> <source src="song.mp3"/> </audio>
Récapitulatif et étapes suivantes
Il est important de penser très sérieusement à la catégorie que vous sélectionnez pour votre flux, car votre application se comportera différemment dans chaque cas.
La rubrique suivante Comment configurer les touches pour les contrôles multimédias, montre comment ajouter et configurer les boutons multimédias pour votre application du Windows Store. Vous pouvez ensuite utiliser ces boutons pour lire, interrompre, arrêter voire avancer rapidement dans un flux audio.
Rubriques associées
Comment configurer les touches pour les contrôles multimédias