/react-native-google-cast

A library that unifies both android and iOS chromecast sdk

Primary LanguageJava

npm version

react-native-google-cast

A library that unifies both android and iOS chromecast sdk

Getting started

$ npm install react-native-google-cast --save

Installation

$ react-native link react-native-google-cast

iOS Heads Up

  • This library requires Cocoapods to manage Chromecast SDK.
  • Add pod 'google-cast-sdk' to your Podfile. This is the easier way to have the SDK up to date.

Android Heads Up

  • This library requires Google Play Services, Media Router and Google Cast dependencies to manage Chromecast SDK.
  • Add
compile 'com.google.android.gms:play-services-cast:9.4.0'
compile 'com.android.support:mediarouter-v7:23.0.1'

into your your app's build.gradle dependencies. mediarouterversion must match with your appcompat version.

Usage

// Require the module
import Chromecast from 'react-native-google-cast';

// Init Chromecast SDK and starts looking for devices (uses DEFAULT APP ID)
Chromecast.startScan();

// Init Chromecast SDK and starts looking for devices using registered APP ID
Chromecast.startScan(APP_ID);

// Does what the method says. It saves resources, use it when leaving your current view
Chromecast.stopScan();

// Returns a boolean with the result
Chromecast.isConnected();

// Return an array of devices' names and ids
Chromecast.getDevices();

// Gets the device id, and connects to it. If it is successful, will send a broadcast
Chromecast.connectToDevice(DEVICE_ID);

// Closes the connection to the current Chromecast
Chromecast.disconnect();

// Streams the media to the connected chromecast. Time parameter let you choose
// in which time frame the media should start streaming
Chromecast.castMedia(MEDIA_URL, MEDIA_TITLE, MEDIA_IMAGE, TIME_IN_SECONDS);

// Move the streaming media to the selected time frame
Chromecast.seekCast(TIME_IN_SECONDS);

// Toggle Chromecast between pause or play state
Chromecast.togglePauseCast();

// Get the current streaming time frame. It can be use to sync the chromecast to
// your visual media controllers
Chromecast.getStreamPosition();

Events

Chromecast uses events to let you know when you should start playing with the service, like streaming the media.

// To know if there are chromecasts around
DeviceEventEmitter.addListener(Chromecast.DEVICE_AVAILABLE, (existance) => console.log(existance.device_available));

// To know if the connection attempt was successful
DeviceEventEmitter.addListener(Chromecast.DEVICE_CONNECTED, () => { /* callback */ });

// If chromecast started to stream the media succesfully, it will send this event
DeviceEventEmitter.addListener(Chromecast.MEDIA_LOADED, () => { /* callback */ });

Constants

  DEVICE_AVAILABLE,
  DEVICE_CONNECTED,
  DEVICE_DISCONNECTED,
  MEDIA_LOADED,

Example

Refer to the example folder to find an implementation of this project. Remember to use

  • pod install
  • react-native link react-native-google-cast

to try it!

Contribution

Contributions are welcome !