Cordova - Media
O plug-in de mídia Cordova é usado para gravar e reproduzir sons de áudio em aplicativos Cordova.
Etapa 1 - Instalando o plug-in de mídia
O plugin de mídia pode ser instalado executando o seguinte código em command prompt janela.
C:\Users\username\Desktop\CordovaProject>cordova plugin add cordova-plugin-media
Etapa 2 - Adicionar botões
Neste tutorial, criaremos um reprodutor de áudio simples. Vamos criar os botões que precisamos emindex.html.
<button id = "playAudio">PLAY</button>
<button id = "pauseAudio">PAUSE</button>
<button id = "stopAudio">STOP</button>
<button id = "volumeUp">VOLUME UP</button>
<button id = "volumeDown">VOLUME DOWN</button>
Etapa 3 - Adicionar ouvintes de eventos
Agora precisamos adicionar ouvintes de eventos para nossos botões dentro onDeviceReady função dentro index.js.
document.getElementById("playAudio").addEventListener("click", playAudio);
document.getElementById("pauseAudio").addEventListener("click", pauseAudio);
document.getElementById("stopAudio").addEventListener("click", stopAudio);
document.getElementById("volumeUp").addEventListener("click", volumeUp);
document.getElementById("volumeDown").addEventListener("click", volumeDown);
Etapa 4A - Função de reprodução
A primeira função que vamos adicionar é playAudio. Estamos definindomyMediafora da função porque queremos usá-lo em funções que serão adicionadas posteriormente (pause, stop, volumeUp e volumeDown). Este código é colocado emindex.js Arquivo.
var myMedia = null;
function playAudio() {
var src = "/android_asset/www/audio/piano.mp3";
if(myMedia === null) {
myMedia = new Media(src, onSuccess, onError);
function onSuccess() {
console.log("playAudio Success");
}
function onError(error) {
console.log("playAudio Error: " + error.code);
}
}
myMedia.play();
}
Podemos clicar PLAY botão para iniciar a música de piano do src caminho.
Etapa 4B - funções de pausa e parada
As próximas funções de que precisamos é pauseAudio e stopAudio.
function pauseAudio() {
if(myMedia) {
myMedia.pause();
}
}
function stopAudio() {
if(myMedia) {
myMedia.stop();
}
myMedia = null;
}
Agora podemos pausar ou parar o som do piano clicando PAUSE ou STOP botões.
Etapa 4C - Funções de Volume
Para definir o volume, podemos usar setVolumemétodo. Este método usa parâmetros com valores de0 para 1. Vamos definir o valor inicial para0.5.
var volumeValue = 0.5;
function volumeUp() {
if(myMedia && volumeValue < 1) {
myMedia.setVolume(volumeValue += 0.1);
}
}
function volumeDown() {
if(myMedia && volumeValue > 0) {
myMedia.setVolume(volumeValue -= 0.1);
}
}
Assim que pressionamos VOLUME UP ou VOLUME DOWN podemos mudar o valor do volume por 0.1.
A tabela a seguir mostra outros métodos que este plugin fornece.
S.Não | Método e detalhes |
---|---|
1 | getCurrentPosition Retorna a posição atual de um áudio. |
2 | getDuration Retorna a duração de um áudio. |
3 | play Usado para iniciar ou retomar o áudio. |
4 | pause Usado para pausar o áudio. |
5 | release Libera os recursos de áudio do sistema operacional subjacente. |
6 | seekTo Usado para alterar a posição de um áudio. |
7 | setVolume Usado para definir o volume do áudio. |
8 | startRecord Comece a gravar um arquivo de áudio. |
9 | stopRecord Pare de gravar um arquivo de áudio. |
10 | stop Pare de reproduzir um arquivo de áudio. |