Guida introduttiva: Aggiunta di audio a un'app (HTML)

  • Articolo

[ Questo articolo è rivolto agli sviluppatori per Windows 8.x e Windows Phone 8.x che realizzano app di Windows Runtime. Gli sviluppatori che usano Windows 10 possono vedere Documentazione aggiornata ]

In questo argomento vengono illustrate le categorie del flusso audio, nonché l'uso del tag <audio> per aggiungere funzionalità di flusso audio all'app

Windows 8 offre una piattaforma che semplifica l'utilizzo di HTML5 per aggiungere alle app di Windows Store funzionalità di flusso audio.

Il tag audio ha i seguenti attributi:

Attributo Valori consentiti Descrizione
autoplay autoplay Specifica che l'audio inizierà a essere riprodotto quando è pronto
controls controls Specifica che devono essere visualizzati i controlli audio (ad esempio un pulsante di riproduzione/pausa e così via).
loop loop Specifica che l'audio verrà riprodotto a ciclo continuo
preload

auto

metadati

nessuna

 Specifica se e come l'autore ritiene debba essere caricato l'audio al caricamento della pagina
src <file path> Specifica il percorso del file audio

 

Microsoft fornisce un attributo aggiuntivo, msAudioCategory, che puoi utilizzare per migliorare il comportamento della tua app in grado di riconoscere l'audio. Nella tabella seguente sono riportati i valori consentiti per questo attributo e una breve descrizione di ciò che fanno.

Categoria di flusso Descrizione Supporto background?
Alert Suoni di avviso con esecuzione a ciclo continuo o prolungata:
  • Sveglie
  • Suonerie
  • Notifica di chiamata in corso
  • Suoni che devono attenuare l'audio esistente
 No
BackgroundCapableMedia Per l'audio che deve continuare a essere riprodotto in background. Tra gli esempi sono inclusi gli scenari di riproduzione di elementi multimediali locali seguenti:
  • Playlist locale
  • Flusso radio
  • Flusso playlist
  • Video musicali
  • Flusso audio o radio, YouTube, Netflix e così via.
 Sì
Communications Per i flussi audio di comunicazione, come i seguenti:
  • VOIP
  • Chat in tempo reale o altri tipi di chiamate telefoniche
 Sì
ForeGroundOnlyMedia Giochi o altri suoni progettati per funzionare solo in primo piano, che disattivano eventuali suoni multimediali esistenti in background.
  • Audio di videogiochi necessario per l'esperienza di gioco (giochi di ballo o musicali)
  • Film (progettati per essere interrotti quando passano in background)
 No
GameEffects Effetti audio di videogiochi progettati per essere combinati con l'audio esistente
  • Dialoghi dei personaggi
  • Tutti i suoni non musicali
 No
GameMedia Musica di sottofondo riprodotta da un videogioco No
SoundEffects Effetti audio di videogiochi o di altri elementi progettati per essere combinati con l'audio esistente:
  • Dialoghi dei personaggi
  • Beep, ding, suoni brevi
 No
Other Tipo di audio predefinito, consigliato per tutti gli elementi multimediali audio che devono continuare a essere riprodotti in background. No

 

Obiettivo: Per aggiungere funzionalità audio a un'app di Windows Store utilizzando il metodo più facile

Prerequisiti

È necessario avere familiarità con il linguaggio HTML, JavaScript, gli eventi di Windows e la gestione di eventi.

Devi avere installato un lettore multimediale in grado di riprodurre MP3 (MPEG-Layer 3) o altri file musicali digitali.

Tempo per il completamento: 15 minuti.

Istruzioni

Aggiunta di audio con il tag <audio>

Quando aggiungi il tag <audio>, devi utilizzare l'attributo "controls" per indicare che desideri che i controlli (pulsanti) vengano visualizzati. La procedura seguente descrive come fare.

  • Copia e incolla il codice seguente nel punto del file HTML in cui desideri che vengano visualizzati i controlli audio:

    // Adding the <audio> tag to your app
<audio controls="controls"> 
<source src="song.mp3"/> 
</audio>

Aggiunta dell'attributo msAudioCategory

L'attributo msAudioCategory aggiunto al tag <audio> ti consente di aggiungere ulteriori funzionalità. L'attributo msAudioCategory assocerà determinati comportamenti avanzati al tag audio migliorando così l'esperienza utente per la tua app. La procedura seguente descrive come aggiungere l'attributo msAudioCategory.

  • Aggiungi l'attributo msAudioCategory all'interno del tag <audio> come illustrato:

    // Enhancing behavior of audio tag
// with the msAudioCategory attribute
<audio msAudioCategory="BackgroundCapableMedia" controls="controls"> 
<source src="song.mp3"/> 
</audio>

Riepilogo e passaggi successivi

Valuta attentamente la categoria che selezioni per il flusso, poiché l'app assumerà un comportamento diverso in ognuno dei casi.

Nell'argomento seguente, Come configurare i tasti per i controlli multimediali, viene descritto come aggiungere e configurare i pulsanti multimediali per l'app di Windows Store. Potrai quindi utilizzare questi pulsanti per la riproduzione, la pausa, l'arresto o l'avanzamento rapido di un flusso audio.

Argomenti correlati

Come configurare i tasti per i controlli multimediali

Esempio di configurazione dei tasti per i controlli multimediali

Esempio di Gestione riproduzione