The Media object provides the ability to record and play back audio files on a device.

var media = new Media(src, mediaSuccess, [mediaError], [mediaStatus]);

Note: The current implementation does not adhere to a W3C specification for media capture, and is provided for convenience only. A future implementation will adhere to the latest W3C specification and may deprecate the current APIs.


  • src: A URI containing the audio content. (DOMString)
  • mediaSuccess: (Optional) The callback that is invoked after a Media object has completed the current play/record or stop action. (Function)
  • mediaError: (Optional) The callback that is invoked if there was an error. (Function)
  • mediaStatus: (Optional) The callback that is invoked to indicate status changes. (Function)


Additional ReadOnly Parameters

  • _position: The position within the audio playback in seconds. Not automatically updated during play, call getCurrentPosition to update.
  • _duration: The duration of the media in seconds.

Supported Platforms

  • Android
  • iOS
  • Windows Phone 7 ( Mango )