rn-youtube-android

Important: Android only

Play videos from YouTube using YouTube's API, in React Native.

• Use version 2.0.0 for react-native >= 0.39
• Use version 1.3.3 for react-native <= 0.38

Known Issues

:warning: Works reliably on version 0.34...0.37 of react-native :warning: Due to react-native's high change pace, I cannot guarentee that this package will work on other versions. Plays fullscreen videos only, in landscape mode only. PRs are welcome :)

Notice

• Since it is a React Native project, it was developed and tested on OSX only, I apologize for the linux folks.
• Intended only for existing Android apps that are integrating React Native - Facebook's instructions.
• Make sure you have the latest React Native/Babel/random cool stuff in your project.
• Using YouTubeAndroidPlayerApi-1.2.2.zip - current version

Getting Started

• Add to settings.gradle:

include ':RNYouTubePlayer', ':app'
project(':RNYouTubePlayer').projectDir = new File(rootProject.projectDir, '<your node_modules path>/rn-youtube-android/android')

• Add to build.gradle:

dependencies {
    ...
    compile project(':RNYouTubePlayer')
}

• In the activity that starts React Native, add the package to the ReactInstanceManager builder:

import com.applicaster.RNYouTubePlayer.YoutubePlayerReactPackage;

...

Builder reactManagerBuilder = ReactInstanceManager.builder()
    .setApplication(getApplication())
    .addPackage(new MainReactPackage())
    .addPackage(new YoutubePlayerReactPackage())
    ...

• Important: In order to get callbacks from the YouToube player, which runs on a separate activity, add this to the activity that holds the ReactInstanceManager:

private ReactInstanceManager reactInstanceManager; // Initialize it following React Native instructions, above

...

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    reactInstanceManager.onActivityResult(this, requestCode, resultCode, data);
}

Usage

• Set up your <YouTube api token>: Google is your friend
• Choose a video from YouTube, like this shameless plug: KawcajJGX-w
• Add to your index.android.js or anywhere inside the project:

import RNYouTubePlayer from 'rn-youtube-android';
RNYouTubePlayer.play(<youtube api token>, <youtube video url - hash only>);

• It is highly recommended to surround the player with await / async in order to reap the future benefits of callbacks:

playVideo = async function(callback) { // example: token and video url exists in props
  try {
    let {
      state,
    } = await RNYouTubePlayer.play('<< YouTube API Token >>', 'KawcajJGX-w');

    if (state === 'stopped') {
      callback(); // stopped watching video, do something
    }
  } catch (e) {
    console.error(e);
  }
};

YouTubeAndroidPlayerApi.jar belongs to Google, Inc. - no copyright infringement intended.