Simple plugin for loading full screen streaming video or audio.
Clone or download

Cordova Streaming Media plugin

For iOS and Android, by Nicholas Hutchind


This plugin allows you to stream audio and video in a fullscreen, native player on iOS and Android.

  • 1.0.0 Works with Cordova 3.x
  • 1.0.1+ Works with Cordova >= 4.0


cordova plugin add

iOS specifics

  • Uses the AVPlayerViewController, supported for iOS 9+.
  • Tested on iOS 11

Android specifics

  • Uses VideoView and MediaPlayer.
  • Creates two activities in your AndroidManifest.xml file.
  • Tested on Android 4.0+


  var videoUrl = STREAMING_VIDEO_URL;

  // Just play a video

  // Play a video with callbacks
  var options = {
    successCallback: function() {
      console.log("Video was closed without error.");
    errorCallback: function(errMsg) {
      console.log("Error! " + errMsg);
    orientation: 'landscape',
    shouldAutoClose: true,  // true(default)/false
    controls: true // true(default)/false. Used to hide controls on fullscreen
  window.plugins.streamingMedia.playVideo(videoUrl, options);

  var audioUrl = STREAMING_AUDIO_URL;

  // Play an audio file (not recommended, since the screen will be plain black)

  // Play an audio file with options (all options optional)
  var options = {
    bgColor: "#FFFFFF",
    bgImageScale: "fit", // other valid values: "stretch", "aspectStretch"
    initFullscreen: false, // true is default. iOS only.
    keepAwake: false, // prevents device from sleeping. true is default. Android only.
    successCallback: function() {
      console.log("Player closed without error.");
    errorCallback: function(errMsg) {
      console.log("Error! " + errMsg);
  window.plugins.streamingMedia.playAudio(audioUrl, options);

  // Stop current audio

  // Pause current audio (iOS only)

  // Resume current audio (iOS only)

Special Thanks

Michael Robinson (@faceleg)

Timothy Shamilov (@shamilovtim)