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.