react-native-theoplayer
Advanced tools
This projects falls under the license as defined in https://github.com/THEOplayer/license-and-disclaimer.
The react-native-theoplayer package provides a THEOplayerView component supporting video playback on the
following platforms:
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.
For each platform, a dependency to the corresponding THEOplayer SDK is included through a dependency manager:
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 sign up for a THEOplayer SDK license through our portal.
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.
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.
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.
| Feature | Android, Android TV, Fire TV | Web | iOS, tvOS |
|---|---|---|---|
| Streaming | MPEG-DASH (fmp4, CMAF), HLS (TS, CMAF), Progressive MP4, MP3 | HLS (TS, CMAF), Progressive MP4, MP3 | |
| Content Protection | Widevine | Widevine, PlayReady, Fairplay | Fairplay |
| DRM Connectors | BuyDRM, EZDRM, Anvato, Titanium, Axinom, Irdeto, VuDRM, Comcast, Verimatrix, Azure, … | ||
| Analytics Connectors | Adobe, Agama, Comscore, Conviva, Mux, Nielsen, Youbora | ||
| Other Connectors | Yospace SSAI | ||
| Subtitles & Closed Captions | CEA-608/708, SRT, TTML, WebVTT | ||
| Metadata | Event stream, emsg, ID3, EXT-X-DATERANGE, EXT-X-PROGRAM-DATE-TIME | ||
| Advertising Integration | Google IMA, Google DAI | ||
| Cast Integration | Chromecast | Chromecast, Airplay | |
| Presentation Mode | Inline, Picture-in-Picture, Fullscreen | ||
| Audio Control Management | Audio focus & Audio-Becoming-Noisy mgmt | (Audio control management by platform) | |
| Advanced APIs | Background playback, Media Session, Media Cache (offline playback) | Background playback, NowPlaying, Media Cache (iOS only) | |
User Interface@theoplayer/react-native-ui | Basic playback, media & text track selection, progress bar, live & vod, preview thumbnails, customisable & extensible |
The react-native-theoplayer package can be combined with any number of connectors to provide extra
functionality. Currently, the following connectors are available:
| Connector | npm package | Source |
|---|---|---|
| Adobe Heartbeat analytics using the Media Collections API |  | Adobe |
| Adobe Media Edge analytics |  | Adobe Edge |
| Agama analytics |  | Agama |
| Comscore analytics |  | Comscore |
| Conviva analytics |  | Conviva |
| Mux analytics |  | Mux |
| Nielsen analytics |  | Nielsen |
| Youbora analytics |  | Youbora |
| Yospace SSAI |  | Yospace |
| Content protection (DRM) |  | DRM |
| React Native Open UI |  | Open UI |
A template forreact-native-theoplayer connectors. |  | Connector template |
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.
This section gives an overview of features, limitations and known issues:
See the API Reference for detailed documentation about all available components and functions.
[8.9.0] - 24-11-29
SURFACE_CONTROL rendering target on Android, which improves switching from/to fullscreen presentation mode. Rendering target SURFACE_CONTROL will be selected instead of SURFACE_VIEW on API level 29+.view parameter in the Omid API from a ref container to a native node handle when registering "friendly" obstructions.FAQs
A THEOplayer video component for react-native.
We found that react-native-theoplayer demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
pnpm 10 blocks lifecycle scripts by default to improve security, addressing supply chain attack risks but sparking debate over compatibility and workflow changes.
Product
Socket now supports uv.lock files to ensure consistent, secure dependency resolution for Python projects and enhance supply chain security.
Research
Security News
Socket researchers have discovered multiple malicious npm packages targeting Solana private keys, abusing Gmail to exfiltrate the data and drain Solana wallets.