react-native-bitmovin-player

Attention! This plugin is not official, the code is not provided or maintained by Bitmovin!

Getting started

$ npm install react-native-bitmovin-player --save

Mostly automatic installation

$ react-native link react-native-bitmovin-player

Manual installation

iOS

1. In XCode, in the project navigator, right click Libraries ➜ Add Files to [your project's name]
2. Go to node_modules ➜ react-native-bitmovin-player and add RNBitmovinPlayer.xcodeproj
3. In XCode, in the project navigator, select your project. Add libRNBitmovinPlayer.a to your project's Build Phases ➜ Link Binary With Libraries
4. Run your project (Cmd+R)

Android

1. Open up android/app/src/main/java/[...]/MainActivity.java

• Add import com.xxsnakerxx.RNBitmovinPlayerPackage; to the imports at the top of the file
• Add new RNBitmovinPlayerPackage() to the list returned by the getPackages() method

2. Append the following lines to android/settings.gradle:

   include ':react-native-bitmovin-player'
   project(':react-native-bitmovin-player').projectDir = new File(rootProject.projectDir, 	'../node_modules/react-native-bitmovin-player/android')

3. Insert the following lines inside the dependencies block in android/app/build.gradle:

   implementation project(':react-native-bitmovin-player')

Add BitmovinPlayer iOS SDK

Add line to your Podfile

pod 'BitmovinPlayer', git: 'https://github.com/bitmovin/bitmovin-player-ios-sdk-cocoapod.git', tag: '2.18.0'.

After that, install the pod using pod install.

Add BitmovinPlayer Android SDK

Add a link to our release repository to your application's build.gradle file. In addition to that, the google maven repository must be added.

allprojects {
    repositories {
        ...
        google()
        maven {
            url 'http://bitmovin.bintray.com/maven'
        }
    }
}

Setup Project

Add the Bundle identifier of the iOS application which is using the SDK as an allowed domain to the Bitmovin licensing backend. This can also be done under Player -> Licenses when logging in into https://dashboard.bitmovin.com with your account.

When you do not do this, you'll get a license error when starting the application which contains the player.

iOS

Add your Bitmovin player license key to the Info.plist file as BitmovinPlayerLicenseKey.

Android

Add your Bitmovin player license key to the AndroidManifest.xml.

<meta-data android:name="BITMOVIN_PLAYER_LICENSE_KEY" android:value="YOUR_KEY_HERE" />

Your player license key can be found when logging in into https://dashboard.bitmovin.com and navigating to Player -> Licenses.

Usage

import BitmovinPlayer from 'react-native-bitmovin-player';

// please follow to index.js for available props
<BitmovinPlayer
  configuration={{
    source: {
      title: 'It works',
      url: 'https://bitdash-a.akamaihd.net/content/sintel/hls/playlist.m3u8',
    },
  }}
/>