Ionic - Cordova Media
Este complemento nos permite grabar y reproducir archivos de audio en un dispositivo.
Usando medios
Al igual que con todos los demás complementos de Cordova, lo primero que debemos hacer es instalarlo desde la ventana del símbolo del sistema.
C:\Users\Username\Desktop\MyApp>cordova plugin add cordova-plugin-media
Ahora, estamos listos para usar el complemento. En el siguiente ejemplo de código,srces el archivo mp3 fuente que usaremos para este tutorial. Se coloca enjs carpeta, pero necesitamos agregar /android_asset/www/ antes, por lo que se puede utilizar en dispositivos Android.
La funcionalidad completa está envuelta dentro del $ionicPlatform.ready()función para asegurar que todo se cargue antes de que se utilice el complemento. Después de eso, estamos creando elmedia objeto utilizando el newMedia(src)método. losmedia El objeto se utiliza para agregar funciones de reproducción, pausa, detención y liberación.
Código del 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();
});
});
}
También crearemos tres botones para llamar a las funciones de reproducción, pausa y parada.
<button class = "button" ng-click = "playMedia()">PLAY</button>
<button class = "button" ng-click = "pauseMedia()">PAUSE</button>
<button class = "button" ng-click = "stopMedia()">STOP</button>
Necesitamos ejecutarlo en un emulador o dispositivo móvil para que este complemento funcione. Cuando el usuario toca el botón de reproducción, elsong.mp3 comenzará a jugar.
Puede ver en el ejemplo anterior que usamos srccomo parámetro de opción. Hay otros parámetros opcionales que se pueden utilizar paranewMedia método.
Parámetros opcionales
La siguiente tabla mostrará todos los parámetros opcionales disponibles.
Parámetro | Tipo | Detalles |
---|---|---|
mediaSuccess | función | Se llama después de que se haya completado la acción actual de reproducción / grabación o detención. |
mediaError | función | Se invoca cuando hay un error. |
mediaStatus | función | Se invoca para mostrar cambios de estado. |
La siguiente tabla mostrará todos los métodos disponibles.
Métodos disponibles
La siguiente tabla mostrará todos los métodos disponibles.
Método | Parámetros | Detalles |
---|---|---|
newMedia (parámetro1) | src | Devuelve el objeto multimedia que se utilizará para métodos futuros. src es un URI del contenido de audio. |
getCurrentPosition | / | Devuelve la posición actual dentro de un archivo de audio. |
getDuration | / | Devuelve la duración de un archivo de audio. |
tocar | / | Se utiliza para iniciar o reanudar la reproducción. |
pausa | / | Se utiliza para pausar la reproducción. |
detener | / | Solía dejar de jugar. |
lanzamiento | / | Se utiliza para liberar recursos de audio. |
seekTo (parámetro1) | milisegundos | Se utiliza para establecer la posición de reproducción en milisegundos. |
setVolume (parámetro1) | volumen | Se usa para cambiar el volumen. El rango es de 0 a 1 |
startRecord () | / | Se utiliza para iniciar la grabación. |
stopRecord | / | Se utiliza para detener la grabación. |