Nobody's Perfect, Man

    react-native-cast

    0.0.5 • Public • Published

    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

    Mostly automatic installation

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

    Manual installation

    iOS

    1. In XCode, in the project navigator, right click LibrariesAdd Files to [your project's name]
    2. Go to node_modulesreact-native-google-cast and add RNGoogleCast.xcodeproj
    3. In XCode, in the project navigator, select your project. Add libRNGoogleCast.a to your project's Build PhasesLink Binary With Libraries
    4. Run your project (Cmd+R)<

    Android

    1. Open up android/app/src/main/java/[...]/MainActivity.java
    • Add import com.reactlibrary.RNGoogleCastPackage; to the imports at the top of the file
    • Add new RNGoogleCastPackage() to the list returned by the getPackages() method
    1. Append the following lines to android/settings.gradle:
      include ':react-native-google-cast'
      project(':react-native-google-cast').projectDir = new File(rootProject.projectDir, 	'../node_modules/react-native-google-cast/android')
      
    2. Insert the following lines inside the dependencies block in android/app/build.gradle:
        compile project(':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 to manage Chromecast SDK.

    ## Usage

    // Require the module
    import Chromecast, { EVENTS } 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({ mediaUrl, title, imageUrl, 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(EVENTS.DEVICE_AVAILABLE, (existance) => console.log(existance.device_available));
     
    // To know if the connection attempt was successful
    DeviceEventEmitter.addListener(EVENTS.DEVICE_CONNECTED, () => { /* callback */ });
     
    // If chromecast started to stream the media succesfully, it will send this event
    DeviceEventEmitter.addListener(EVENTS.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 !

    Install

    npm i react-native-cast

    DownloadsWeekly Downloads

    2

    Version

    0.0.5

    License

    MIT

    Last publish

    Collaborators

    • matiastucci