react-native-theoplayer

React Native THEOplayer

License

This projects falls under the license as defined in https://github.com/THEOplayer/license-and-disclaimer.

Table of Contents

1. Overview
2. Prerequisites
3. How to use these guides
4. Features
5. Available connectors
6. Getting Started

Overview

The react-native-theoplayer package provides a THEOplayerView component supporting video playback on the following platforms:

• Android, Android TV & FireTV
• iOS & tvOS (Apple TV)
• HTML5, Tizen & webOS (web, mobile web, smart TVs, set-top boxes and gaming consoles).

This document covers the creation of a minimal app including a THEOplayerView component, and an overview of the accompanying example app with a user interface provided by the @theoplayer/react-native-ui package.

It also gives a description of the properties of the THEOplayerView component, and a list of features and known limitations.

Prerequisites

For each platform, a dependency to the corresponding THEOplayer SDK is included through a dependency manager:

• Gradle & Maven for Android
• Cocoapods for iOS
• npm for Web

In order to use one of these THEOplayer SDKs, it is necessary to obtain a valid THEOplayer license for that specific platform, i.e. HTML5, Android, and/or iOS. You can use your existing THEOplayer SDK license or request a free trial account.

If you have no previous experience in React Native, we encourage you to first explore the React Native Documentation, as it gives you a good start on one of the most popular app development frameworks.

How to use these guides

These are guides on how to use the THEOplayer React Native SDK in your React Native project(s) and can be used linearly or by searching the specific section. It is recommended that you have a basic understanding of how React Native works to speed up the way of working with THEOplayer React Native SDK.

Features

Depending on the platform on which the application is deployed, a different set of features is available.

If a feature missing, additional help is needed, or you need to extend the package, please reach out to us for support.

Available connectors

The react-native-theoplayer package can be combined with any number of connectors to provide extra functionality. Currently, the following connectors are available:

Package name	Purpose	Registry
@theoplayer/react-native-analytics-adobe	Adobe analytics connector
@theoplayer/react-native-analytics-agama	Agama analytics connector
@theoplayer/react-native-analytics-comscore	Comscore analytics connector
@theoplayer/react-native-analytics-conviva	Conviva analytics connector
@theoplayer/react-native-analytics-mux	Mux analytics connector
@theoplayer/react-native-analytics-nielsen	Nielsen analytics connector
@theoplayer/react-native-analytics-youbora	Youbora analytics connector
@theoplayer/react-native-drm	Content protection (DRM) connectors
@theoplayer/react-native-ui	React Native user interface
@theoplayer/react-native-connector-template	A template for react-native-theoplayer connectors.

Getting Started

This section starts with creating a minimal demo app that integrates the react-native-theoplayer package, followed by an overview of the available properties and functionality of the THEOplayerView component. An example application including a basic user interface and demo sources is included in the git repository, and discussed in the next section. Finally, an overview of features, limitations and known issues is listed.

• Creating a minimal demo app
  • Getting started on Android
  • Getting started on iOS
  • Getting started on Web
• The THEOplayerView component
• The example application
• Knowledge Base
  • Adaptive Bitrate (ABR)
  • Advertisements
  • Audio Control Management
  • Background playback and notifications
  • Casting with Chromecast and Airplay
  • Custom iOS framework
  • Digital Rights Management (DRM)
  • Fullscreen presentation
  • Media Caching
  • Migrating to react-native-theoplayer v2.x
  • Picture-in-Picture (PiP)
  • Subtitles, Closed Captions and Metadata tracks
  • Limitations and known issues

Changelog

[3.10.0] - 24-03-15

Changed

• Updated dependencies and example app to support ReactNative v0.73.
• Updated ios sdk version to 6.11

Fixed

• Improved NowPlayingInfo updates for iOS by setting playbackRate on pause/playing events and processing the final info on player desctruction.
• Fixed an issue with misinterpretation of targetVideoQuality = 0 (use video track with uid == 0) as targetVideoQuality = undefined (use ABR across all video qualities).
• Fixed an issue where the srclang property of a textTrack passed to a SourceDescription would not be parsed on Android.

Added

• Added an optional THEOplayer_reparent_on_fullscreen build property on Android to disable THEOplayerView reparenting when transitioning to fullscreen presentation mode.