Ионный - Cordova Media

Этот плагин позволяет нам записывать и воспроизводить аудиофайлы на устройстве.

Использование СМИ

Как и все остальные плагины Cordova, первое, что нам нужно сделать, это установить его из окна командной строки.

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

Теперь мы готовы использовать плагин. В следующем примере кодаsrc- это исходный mp3-файл, который мы будем использовать в этом руководстве. Он находится вjs папку, но нам нужно добавить /android_asset/www/ перед этим, поэтому его можно использовать на устройствах Android.

Полная функциональность заключена в $ionicPlatform.ready()функция, чтобы убедиться, что все загружено до использования плагина. После этого мы создаемmedia объект с помощью newMedia(src)метод. Вmedia объект используется для добавления функций воспроизведения, паузы, остановки и освобождения.

Код контроллера

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

Мы также создадим три кнопки для вызова функций воспроизведения, паузы и остановки.

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

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

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

Нам нужно запустить его на эмуляторе или мобильном устройстве, чтобы этот плагин работал. Когда пользователь нажимает кнопку воспроизведения,song.mp3 начнет играть.

В приведенном выше примере вы можете видеть, что мы используем srcкак дополнительный параметр. Есть и другие необязательные параметры, которые можно использовать дляnewMedia метод.

Дополнительные параметры

В следующей таблице будут показаны все доступные дополнительные параметры.

Параметр	Тип	Детали
mediaSuccess	функция	Вызывается после завершения текущего воспроизведения / записи или остановки.
mediaError	функция	Вызывается при возникновении ошибки.
mediaStatus	функция	Вызывается для отображения изменений статуса.

В следующей таблице будут показаны все доступные методы.

Доступные методы

В следующей таблице показаны все доступные методы.

Метод	Параметры	Детали
newMedia (параметр1)	src	Возвращает медиа-объект, который будет использоваться для будущих методов. src - это URI аудиоконтента.
getCurrentPosition	/	Возвращает текущую позицию в аудиофайле.
getDuration	/	Возвращает продолжительность аудиофайла.
играть в	/	Используется для начала или возобновления игры.
Пауза	/	Используется для приостановки воспроизведения.
стоп	/	Используется для остановки игры.
выпуск	/	Используется для освобождения аудиоресурсов.
seekTo (параметр1)	миллисекунды	Используется для установки позиции воспроизведения в миллисекундах.
setVolume (параметр1)	объем	Используется для изменения громкости. Диапазон от 0 до 1
startRecord ()	/	Используется для начала записи.
stopRecord	/	Используется для остановки записи.