Radiant Media Player

Android TV apps with Cordova

Scope of support

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

  • Web applications for Android TV built with Cordova and Android Studio
  • Targeting deployment on Android TV 8+ with Cordova 9+

To get general information on Android TV apps follow that guide.

To get directly to the code part with our demo app on GitHub go here.

Using Radiant Media Player in an Android TV applictation is only available for PLATFORM edition customers as FILE protocol support is required.

Supported features

Most player features available for the web are generally available with Radiant Media Player for Android TV applications built with Cordova. Below is a non-exhaustive list of features you can expect to be available:

Feature Android TV 8+ with Cordova 9+
MP4 progressive download
HTML5 video ads (1)
VOD & Live streaming
DVR streaming (2)
Autoplay (with audio) support
Dedicated TV skin
Player API
Widevine DRM (DASH) (3)

Android TV player skin

We provide an out-of-box tv-optimized player skin to help you get started with your Android TV app. Note that it is a requirement to use the TV skin when building an Android TV app with Radiant Media Player and Cordova. This skin defaults to a full window mode ideal for a fullscreen experience on larger displays and triggers various optimisations for Android TV. The tv-optimized player skin can be enabled through the skin setting set to 'tv'. See our player skins documentation for more information.

Android TV Demo App

To make it straight-forward for Radiant Media Player customers to start developing an Android TV app with Cordova, we have released a complete demo app on GitHub. This demo comes with a dedicated Cordova plugin to prepare a Cordova-based Android app for Android TV deployment. This demo app is available here.

Video ads support in Android TV apps

We do support using video ads in a Cordova-based Android TV app. It should be noted that since the HTML5 Google IMA SDK is not officially supported in Android TV app, the preferred solution is to use our VAST parser rmp-vast. However if you are using Google Ads (Google Ad Manager, AdSense for Video) we still recommend using the IMA SDK even in a Android TV app. The VAST parser can be selected with player setting adParser set to 'ima' or 'rmp-vast'.

Widevine DRM support in Android TV apps

We support Widevine DRM (DASH) on Android TV 8+ devices (WebView version must be minimum of 58). Just pass DRM information to the TV player as you would normally do with our web player. See our DRM documentation for more information.

App white-listing (PLATFORM Edition)

By default you can use your platform edition license key on any app requiring the FILE protocol. However you may want, and it is recommended, to lock down usage of your license key to a limited number of apps. Review this section for enabling App white-listing.

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

©2015-2021 Radiant Media Player. All rights reserved.