Share via


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 :
  • Alarmes
  • Sonneries de téléphone
  • Notification sonore
  • Sons qui doivent atténuer une animation sonore existante
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 :
  • Playlist locale
  • Radio en streaming
  • Playlist en streaming
  • Vidéos musicales
  • Audio/vidéo en streaming, YouTube, Netflix, etc.
Oui
Communications Pour du son de communication en streaming comme :
  • VOIP
  • Discussion en temps réel ou autre type d’appel téléphonique
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.
  • Animation sonore nécessaire pour l’expérience du jeu (jeux de danse, jeux musicaux)
  • Longs-métrages (conçus pour se mettre en pause lorsqu’ils passent en arrière-plan)
Non
GameEffects Effets sonores de jeu conçus pour se mélanger à des sons existants
  • Personnages dialoguant
  • Tous les sons non musicaux
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 :
  • Personnages dialoguant
  • Bips, dings, sons brefs
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

Exemple de configuration des touches multimédias

Exemple de gestionnaire de lecture