react-native-permissions

Discovery

Discover nearby devices using BLE.

React native implementation of https://github.com/omergul123/Discovery

(Android uses https://github.com/joshblour/discovery-android)

What

Discovery is a very simple but useful library for discovering nearby devices with BLE(Bluetooth Low Energy) and for exchanging a value (kind of ID or username determined by you on the running app on peer device) regardless of whether the app on peer device works at foreground or background state.

Example

const {DeviceEventEmitter} = require('react-native');
const Discovery = require('react-native-discovery');

Discovery.initialize(
  "3E1180E5-222E-43E9-98B4-E6C0DD18E728",
  "SpacemanSpiff"
);
Discovery.setShouldAdvertise(true);
Discovery.setShouldDiscover(true);

// Listen for discovery changes
DeviceEventEmitter.addListener(
  'discoveredUsers',
  (data) => {
    if (data.didChange || data.usersChanged) //slight callback discrepancy between the iOS and Android libraries
      console.log(data.users)
  }
);

API

initialize(uuidString, username) - Initialize the Discovery object with a UUID specific to your app, and a username specific to your device.

setPaused(isPaused) - bool. pauses advertising and detection

setShouldDiscover(shouldDiscover) - bool. starts and stops discovery only

setShouldAdvertise(shouldAdvertise) - bool. starts and stops advertising only

setUserTimeoutInterval(userTimeoutInterval) - integer in seconds, default is 5. After not seeing a user for x seconds, we remove him from the users list in our callback.

The following two methods are specific to the Android version, since the Android docs advise against continuous scanning. Instead, we cycle scanning on and off. This also allows us to modify the scan behaviour when the app moves to the background.

setScanForSeconds(scanForSeconds) - integer in seconds, default is 5. This parameter specifies the duration of the ON part of the scan cycle.

setWaitForSeconds(waitForSeconds) - integer in seconds default is 5. This parameter specifies the duration of the OFF part of the scan cycle.

Setup

npm install --save react-native-discovery

iOS

• Run open node_modules/react-native-discovery
• Drag ReactNativeDiscovery.xcodeproj into your Libraries group

Android

Step 1 - Update Gradle Settings

// file: android/settings.gradle
...

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

Step 2 - Update Gradle Build

// file: android/app/build.gradle
...

dependencies {
    ...
    compile project(':react-native-discovery')
}

Step 3 - Register React Package

...
import com.joshblour.reactnativediscovery.ReactNativeDiscoveryPackage; // <--- import

public class MainActivity extends ReactActivity {

    ...

    @Override
    protected List<ReactPackage> getPackages() {
        return Arrays.<ReactPackage>asList(
            new MainReactPackage(),
            new ReactNativeDiscoveryPackage(this) // <------ add the package
        );
    }

    ...
}