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.