This plugin provides the ability to record and play back audio files on a device.

A note on iOS capabilities

An app that plays or records audio continuously (even while the app is running in the background) can register to perform those tasks in the background. You enable audio support from the Background modes section of the Capabilities tab in your Xcode project. (You can also enable this support by including the UIBackgroundModes key with the audio value in your app’s Info.plist file.) Apps that play audio content in the background must play audible content and not silence.

Apple reference “Playing and Recording Background Audio”

cordova plugin add cordova-plugin-media

Methods

newMedia(source)

Returns Object - media object, to be used for future methods

play(options) - options for iOS only

Start or resume playing an audio file. Options are only available for iOS devices.

Options	Type	Detail
numberOfLoops	Integer	Number of times you want the media file to play
playAudioWhenScreenIsLocked	Boolean	Allow playback when the screen is locked

pause()

Pause playback of an audio file.

stop()

Stop playing an audio file.

release()

Releases the underlying operating system’s audio resources.

seekTo(milliseconds)

Moves the position within the audio file.

setVolume(volume)

Set the volume for audio playback.

startRecord()

Start recording an audio file.

stopRecord()

Stop recording an audio file.

getDuration()

Get the duration of an audio file.

getCurrentPosition()

Get the current position within an audio file.

Example

module.controller('MyCtrl', function($scope, $cordovaMedia) {

  var src = "/src/audio.mp3";
  var media = $cordovaMedia.newMedia(src);


  var iOSPlayOptions = {
    numberOfLoops: 2,
    playAudioWhenScreenIsLocked : false
  }

  media.play(iOSPlayOptions); // iOS only!
  media.play(); // Android

  media.pause();

  media.stop();

  media.release();

  media.seekTo(5000); // milliseconds value

  media.setVolume(0.5);

  media.startRecord();

  media.stopRecord();

  media.getDuration();

  media.getCurrentPosition().then(...);
});