Ionic - Cordova Media

Este plugin nos permite gravar e reproduzir arquivos de áudio em um dispositivo.

Usando mídia

Como acontece com todos os outros plug-ins do Cordova, a primeira coisa que precisamos fazer é instalá-lo a partir da janela do prompt de comando.

C:\Users\Username\Desktop\MyApp>cordova plugin add cordova-plugin-media

Agora, estamos prontos para usar o plugin. No exemplo de código a seguir,srcé o arquivo mp3 de origem que usaremos neste tutorial. É colocado emjs pasta, mas precisamos adicionar /android_asset/www/ antes dele, para que possa ser usado em dispositivos Android.

A funcionalidade completa está dentro do $ionicPlatform.ready()função para garantir que tudo seja carregado antes que o plugin seja usado. Depois disso, estamos criando omedia objeto usando o newMedia(src)método. omedia O objeto é usado para adicionar funcionalidades de reprodução, pausa, parada e liberação.

Código do Controlador

.controller('MyCtrl', function($scope, $ionicPlatform, $cordovaMedia) {
   $ionicPlatform.ready(function() {
      var src = "/android_asset/www/js/song.mp3";
      var media = $cordovaMedia.newMedia(src);

      $scope.playMedia = function() {
         media.play();
      };

      $scope.pauseMedia = function() {
         media.pause();
      };

      $scope.stopMedia = function() {
         media.stop();
      };

      $scope.$on('destroy', function() {
         media.release();
      });
   });
}

Também criaremos três botões para chamar as funções play, pause e stop.

<button class = "button" ng-click = "playMedia()">PLAY</button>

<button class = "button" ng-click = "pauseMedia()">PAUSE</button>

<button class = "button" ng-click = "stopMedia()">STOP</button>

Precisamos executá-lo em um emulador ou dispositivo móvel para que este plugin funcione. Quando o usuário toca no botão play, osong.mp3 vai começar a jogar.

Você pode ver no exemplo acima que usamos srccomo um parâmetro de opção. Existem outros parâmetros opcionais que podem ser usados ​​para onewMedia método.

Parâmetros Opcionais

A tabela a seguir mostrará todos os parâmetros opcionais disponíveis.

Parâmetro Tipo Detalhes
mediaSuccess função Chamado depois que a ação atual de reprodução / gravação ou parada for concluída.
mediaError função Chamado quando há um erro.
mediaStatus função Chamado para mostrar mudanças de status.

A próxima tabela mostrará todos os métodos disponíveis.

Métodos Disponíveis

A tabela a seguir mostra todos os métodos disponíveis.

Método Parâmetros Detalhes
newMedia (parâmetro1) src Retorna o objeto de mídia que será usado para métodos futuros. src é um URI do conteúdo de áudio.
getCurrentPosition / Retorna a posição atual em um arquivo de áudio.
getDuration / Retorna a duração de um arquivo de áudio.
jogar / Usado para iniciar ou retomar a reprodução.
pausa / Usado para pausar a reprodução.
Pare / Costumava parar de jogar.
lançamento / Usado para liberar recursos de áudio.
searchTo (parâmetro1) milissegundos Usado para definir a posição de reprodução em milissegundos.
setVolume (parâmetro1) volume Usado para alterar o volume. O intervalo é de 0 a 1
startRecord () / Usado para iniciar a gravação.
stopRecord / Usado para parar a gravação.