Guia de início rápido: adicionando áudio a um aplicativo (HTML)
[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente ]
Este tópico explica as categorias de streaming de áudio e mostra como usar a marca <audio> para adicionar recursos de streaming de áudio em seu aplicativo.
O Windows 8 fornece uma plataforma que torna relativamente simples o uso de HTML5 para adicionar recursos de streaming de áudio a um aplicativo da Windows Store.
A marca audio tem os atributos a seguir.
| Atributo | Valores permitidos | Descrição |
|---|---|---|
| autoplay | autoplay | Especifica que o áudio começará a reproduzir assim que estiver pronto |
| controles | controles | Especifica que os controles de áudio devam ser exibido (como o botão de reproduzir/pausa etc). |
| loop | loop | Especifica que o áudio recomeçará, sempre que acabar |
| preload | auto metadata none |
Especifica se e como o autor pensa que o áudio deve ser carregado quando a página carrega |
| src | <file path> | Especifica o caminho para a propriedade de origem de associação. |
A Microsoft fornece um atributo adicional, msAudioCategory, que você pode usar para melhorar o comportamento de seu aplicativo que reconhece áudio. A seguinte tabela mostra os valores permitidos deste atributo e descrições breves do que eles fazem.
| Categoria de fluxo | Descrição | Capaz de tela de fundo? |
|---|---|---|
| alerta | O alerta de execução mais longo ou em loop soa:
|
Não |
| BackgroundCapableMedia | Para áudio que precisa continuar reprodução em tela de fundo. Exemplos incluem os seguintes cenários de reprodução de mídia local:
|
Sim |
| Communications | Para fazer streaming em áudio de comunicação como:
|
Sim |
| ForeGroundOnlyMedia | Os sons de jogos ou outros sons projetados só para funcionar em tela de fundo, mas silenciarão os sons de mídia de plano de fundo existentes.
|
Não |
| GameEffects | Efeitos de sons de jogos designados a misturar com o áudio existente
|
Não |
| GameMedia | A música em tela de fundo reproduzida por um jogo | Não |
| SoundEffects | Efeitos de jogos ou outros efeitos sonoros para mixarem com áudio existente:
|
Não |
| Outro | Tipo de áudio padrão e recomendado para todas as mídias de áudio que não precise continuar sendo reproduzida em tela de fundo. | Não |
Objetivo: Para adicionar recursos de áudio a um aplicativo da Windows Store usando o método mais simples
Pré-requisitos
Estar familiarizado com eventos HTML, JavaScript e do Windows, bem como com a manipulação de eventos.
Você deve ter um reprodutor de mídia instalado que possa reproduzir MP3 ou outros arquivos de música digital.
Tempo para conclusão: 15 minutos.
Instruções
Adicionando áudio com a marca <audio>
Ao adicionar a marca <audio>, você precisa usar o atributo "controls" para indicar que quer que os controles (os botões) sejam exibidos. A etapa a seguir mostra como fazer isso.
Copie e cole o código seguinte no local de seu arquivo HTML onde você quer que o controle de áudio seja exibido:
// Adding the <audio> tag to your app <audio controls="controls"> <source src="song.mp3"/> </audio>
Adicionando o atributo msAudioCategory
Quando você adiciona o atributo msAudioCategory à marca <audio>, adiciona funcionalidade. O atributo msAudioCategory associará certos comportamentos melhorados à sua marca audio e isso melhorará a experiência de usuário com seu aplicativo. A seguinte etapa mostra como adicionar o atributo msAudioCategory.
Adicione o atributo msAudioCategory dentro da marca <audio> como mostrado:
// Enhancing behavior of audio tag // with the msAudioCategory attribute <audio msAudioCategory="BackgroundCapableMedia" controls="controls"> <source src="song.mp3"/> </audio>
Resumo e próximas etapas
É importante pensar muito cuidadosamente sobre a categoria que você seleciona para o seu fluxo, porque o seu aplicativo se comportará diferentemente em cada caso.
O próximo tópico, Como configurar teclas para controles de mídia, mostra como adicionar e configurar botões de mídia no seu aplicativo da Windows Store. Você pode usar esses botões para reproduzir, pausar, parar ou até mesmo avançar um fluxo de áudio.
Tópicos relacionados
Como configurar teclas para controles de mídia