Ionic - Cordova Media

Ce plugin nous permet d'enregistrer et de lire des fichiers audio sur un appareil.

Utilisation des médias

Comme pour tous les autres plugins Cordova, la première chose à faire est de l'installer à partir de la fenêtre d'invite de commande.

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

Maintenant, nous sommes prêts à utiliser le plugin. Dans l'exemple de code suivant,srcest le fichier mp3 source que nous utiliserons pour ce tutoriel. Il est placé dansjs dossier, mais nous devons ajouter /android_asset/www/ avant, afin qu'il puisse être utilisé sur les appareils Android.

La fonctionnalité complète est enveloppée dans le $ionicPlatform.ready()pour s'assurer que tout est chargé avant l'utilisation du plugin. Après cela, nous créons lemedia objet en utilisant le newMedia(src)méthode. lemedia l'objet est utilisé pour ajouter des fonctionnalités de lecture, de pause, d'arrêt et de libération.

Code du contrôleur

.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();
      });
   });
}

Nous allons également créer trois boutons pour appeler les fonctions de lecture, de pause et d'arrêt.

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

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

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

Nous devons l'exécuter sur un émulateur ou un appareil mobile pour que ce plugin fonctionne. Lorsque l'utilisateur appuie sur le bouton de lecture, lesong.mp3 commencera à jouer.

Vous pouvez voir dans l'exemple ci-dessus que nous utilisons srccomme paramètre d'option. Il existe d'autres paramètres facultatifs qui peuvent être utilisés pournewMedia méthode.

Paramètres facultatifs

Le tableau suivant affiche tous les paramètres facultatifs disponibles.

Paramètre	Type	Détails
mediaSuccès	fonction	Appelé après la fin de la lecture / enregistrement en cours ou de l'action d'arrêt.
mediaError	fonction	Invoqué lorsqu'il y a une erreur.
mediaStatus	fonction	Appelé pour afficher les changements de statut.

Le tableau suivant montrera toutes les méthodes disponibles.

Méthodes disponibles

Le tableau suivant montre toutes les méthodes disponibles.

Méthode	Paramètres	Détails
newMedia (paramètre1)	src	Renvoie un objet multimédia qui sera utilisé pour les futures méthodes. src est un URI du contenu audio.
getCurrentPosition	/	Renvoie la position actuelle dans un fichier audio.
getDuration	/	Renvoie la durée d'un fichier audio.
jouer	/	Utilisé pour démarrer ou reprendre la lecture.
pause	/	Utilisé pour interrompre la lecture.
Arrêtez	/	Utilisé pour arrêter la lecture.
Libération	/	Utilisé pour libérer des ressources audio.
seekTo (paramètre1)	millisecondes	Utilisé pour définir la position de lecture en millisecondes.
setVolume (paramètre1)	le volume	Utilisé pour changer le volume. La plage est de 0 à 1
startRecord ()	/	Utilisé pour démarrer l'enregistrement.
stopEnregistrement	/	Utilisé pour arrêter l'enregistrement.