README.md

Cordova Streaming Media Secure plugin

For iOS and Android, by Suhas P R, Stuart McCamley & Nicholas Hutchind

Description

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

Installation

cordova plugin add cordova-plugin-streaming-media-secure

iOS specifics

• Uses the Swift MediaPlayer.
• Tested on iOS 10.x

Android specifics

• Uses VideoView and MediaPlayer.
• Creates two activities in your AndroidManifest.xml file.
• Tested on Android 4.0+
• Adds FLAG_SECURE to prevent user from taking screenshot and screen recording

Usage iOS

if(window && window.plugins && window.plugins.streamingMedia) {
  let StreamingMedia = window.plugins.streamingMedia
  // play streaming video from a remove resource
  StreamingMedia.playiOS('url')
  StreamingMedia.playLocaliOS("local file path")
}

Usage Android

  var videoUrl = STREAMING_VIDEO_URL;

  // Just play a video
  window.plugins.streamingMedia.playVideo(videoUrl);

  // 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
    secure: true // true(default)/false. Used to prevent user from taking screenshot and screen recording
  };
  window.plugins.streamingMedia.playVideo(videoUrl, options);


  var audioUrl = STREAMING_AUDIO_URL;

  // Play an audio file (not recommended, since the screen will be plain black)
  window.plugins.streamingMedia.playAudio(audioUrl);

  // Play an audio file with options (all options optional)
  var options = {
    bgColor: "#FFFFFF",
    bgImage: "<SWEET_BACKGROUND_IMAGE>",
    bgImageScale: "fit", // other valid values: "stretch"
    initFullscreen: false, // true(default)/false iOS 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
  window.plugins.streamingMedia.stopAudio();

  // Pause current audio (iOS only)
  window.plugins.streamingMedia.pauseAudio();

  // Resume current audio (iOS only)
  window.plugins.streamingMedia.resumeAudio();