Spot SDK

The Spot SDK is a React native package to provide the Spot controller functionality to any React Native apps, such as Jitsi Meet.

Usage

1. Install the module

npm install @jitsi/spot-sdk

2. Add and install peer dependencies

Check the package.json to see the most actual list of peerDependencies. To see what exact version the SDK was developed and tested against please also see the devDependencies section of the same file.

3. Add native stuff

3.1 iOS

3.1.1 Add the permissions to Info.plist

These permissions are needed to be able to detect nearby spot devices.

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>Allows MyFirstSpotApp to detect Spot TVs and Spot TV equipped meeting rooms nearby.</string>
<key>NSBluetoothPeripheralUsageDescription</key>
<string>Allows MyFirstSpotApp to detect Spot TVs and Spot TV equipped meeting rooms nearby.</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>Allows MyFirstSpotApp to detect Spot TVs and Spot TV equipped meeting rooms nearby.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>Allows MyFirstSpotApp to detect Spot TVs and Spot TV equipped meeting rooms nearby.</string>
<key>NSLocationUsageDescription</key>
<string>Allows MyFirstSpotApp to detect Spot TVs and Spot TV equipped meeting rooms nearby.</string>

3.2 Android

3.2.1 Add the permission to your manifest

These permissions are needed to be able to detect nearby spot devices.

<uses-permission  android:name="android.permission.ACCESS_COARSE_LOCATION"/>

4. Initialize the SDK

Put the SDK initializer code to a part of your app that runs early enough (e.g. main view mount), but not in the module loading phase!

// Optional
SpotSDK.initialize(new Config({ /* config values come here, if needed */}));
// Optional
SpotSDK.startDeviceDetection();

5. Use the components

5.1 SpotStreamButton

SpotStreamButton is a button that will appear or disappear automatically should a nearby spot device is detected.

Props:

iconColor: Color of the rendered button (optional).
iconSize: Size of the rendered button (optional).
onPress: Callback to be invoked when the button is pressed.
style: External size to be applied (optional).
children: The component may have children, in which case the children are rendered as button, instead of the default icon.

5.2 SpotNearbyDevicesList

SpotNearbyDevicesList is a component to render the lis of nearby devices.

Props

defaultDeviceName: Device name to be displayed for devices with no available name (Optional).
onSelect: The callback to be invoked on selecting a device from the list.
style: External size to be applied (optional).

5.3 SpotView

SpotView is a view that renders the Spot remote controller screen.

Props

device: The device we want to control, if any. Otherwise a spot controller is opened with the code entry screen to control a non beacon-enabled instance (optional). style: External size to be applied (optional).