Radiant Media Player

Web-based mobile applications support



Web-based mobile applications documentation sections


Scope of support for building web-based mobile applications with Radiant Media Player

You can use Radiant Media Player to build media-oriented web-based mobile applications for Android and iOS. The player is equipped with various optimisations, notably file:// protocol support, to work in the following environments:

  • Applications built with Apache Cordova: this includes support for frameworks and tools like Ionic or PhoneGap. This applications require file:// protocol.
  • Standalone web applications.
  • WebView created from native code: for example when viewing content through Facebook in-app browser.

Using Radiant Media Player in a Cordova-based application is only available for PLATFORM edition customers as FILE protocol support is required. Using Radiant Media Player within a standalone application or a WebView through the HTTP protocol is available for all player editions.


Supported OS

Radiant Media Player can be used to build web-based mobile applications for the following mobile OS:

  • Android 5+
  • iOS 9+

It is possible that Radiant Media Player used in web-based mobile applications would work on previous versions of Android or iOS but they are not officially supported.


Supported features

All player features available for the mobile web are generally available with Radiant Media Player for web-based mobile applications. Below is a non-exhaustive list of features you can expect to be available or not when using Radiant Media Player in a web-based mobile application:

Feature Android iOS
HLS
AES HLS
DASH
Progressive download
HTML5 video ads (1)
Widevine DRM (HLS or DASH)
VOD & Live streaming
DVR streaming (2)
360 video
Autoplay (with audio) support (3)
Mobile-first & responsive UI
Player API
Google Cast (4)
AirPlay
Offline playback (5)
  • (1) Video ads in a cordova-based mobile app or WebView are rendered through rmp-vast. Refer to this article for a list of supported ad types. While it is still technically possible to use the IMA SDK in such environment we generally recommend using rmp-vast as the HTML5 IMA SDK does not officially support cordova-based mobile app or WebView.
  • (2) DVR functionalities are only available on iOS 11+ when the player is in fullscreen mode - in window mode or with previous iOS versions the DVR stream will be handled as a simple live stream
  • (3) autoplay (with audio) is available in WebView and Cordova-based applications when the FILE protocol is used. In standalone mode, Facebook in-app browser or HTTP WebView only muted autoplay will be available.
  • (4) See the Google Cast support in Android web-based application section
  • (5) See the offline playback section

Offline playback

Since Radiant Media Player 4.6.0 we support offline playback of media content (HLS, DASH or progressive download) within an Android or iOS web-based application. In order to be displayed, offline content must be locally stored within the application (like in an assets/ or media/ folder). The player must point to this locally stored resource in order to start playback (through the usual bitrates setting). The mechanism where online media content could be dynamically saved on the device is not covered by Radiant Media Player.

Supported features:

  • Playback of HLS, DASH, progressive download on-demand content
  • Player settings and API that do not require an Internet connection are generally available
  • Video ads: only supported with rmp-vast (IMA SDK not available). In this case the adTag must be hosted locally within the app. The adTagUrl setting must point to this local resource. VAST metrics will not be ping since the device is offline.

Unsupported features:

  • Offline DRM licenses
  • Live & DVR streaming: those types of content require an Internet connection to run

Offline playback requires a PLATFORM Edition license key. Offline player starts are saved locally and push to our logging servers when an Internet connection becomes available.


Google Cast support in Android web-based application

As stated in the Cast SDK forum Google Cast casting from a Chromium WebView is not supported. Hence we do not support Google Cast casting from Radiant Media Player in an Android web-based mobile application. This does not mean it is not possible though. Google Cast support may be provided through a Cordova plugin. Various solutions are available on GitHub and while we do not recommend any specific solution, this one seems to be popular. When using such a plugin you would need to build your own cast and remote controlling logic outside the player.

Google Cast support through Radiant Media Player is available in standalone web applications or in Chrome for Android.


Using Radiant Media Player in a Cordova-based application

Refer to our Working with Apache Cordova guide.


Using Radiant Media Player in a Ionic-based application

Refer to our Working with Ionic Framework guide.


Using Radiant Media Player in a PhoneGap-based application

Refer to our Working with Adobe PhoneGap guide.


Using Radiant Media Player in a standalone web application

A standalone web application is designed to look and behave in a way similar to a native application - for example, it is scaled to fit the entire screen of a device. You can tailor your web application for Safari on iOS or Chrome for Android even further, by making it appear like a native application when the user adds it to the "Home screen".

When embedded in a standalone web application the player adds the rmp-standalone class to its container (HTML element with the rmp-container class). You can also query the player API isStandalone method which should return a boolean clearly stating if the player is currently used in a standalone web-app or not.


iOS

Apple has documentation on how to configure standalone web applications. Notably this is achieved by adding the following meta tag to your HTML page:

<meta name="apple-mobile-web-app-capable" content="yes">

Android

For Chrome on Android Google has a guide for Installable Web Apps with the Web App Manifest. This approach follows the W3C Web App Manifest specification which is also available in Firefox and Opera.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License.