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. |