Skip to content

A very simple Bluetooth advertiser and scanner for React Native.

License

Notifications You must be signed in to change notification settings

ujw0712/react-native-ble-phone-to-phone

Repository files navigation

react-native-ble-phone-to-phone npm version npm downloads GitHub issues

A very simple Bluetooth advertiser and scanner for React Native.

Supported Platforms

  • ReactNative 0.71+
  • Android 21+
  • Bluetooth API 5.0+

Features

  • Android Advertiser
  • Android Scanner
  • iOS Advertiser
  • iOS Scanner

Installation

npm install react-native-ble-phone-to-phone --save

or

yarn add react-native-ble-phone-to-phone

Setting up the Android Project

In the AndroidManifest.xml file, add the Bluetooth permissions

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

Usage

Advertiser

Import the module

import {
  advertiseStart,
  advertiseStop,
} from 'react-native-ble-phone-to-phone';

Define uuid to start advertise. or Start advertise without uuid.

const uuid = '26f08670-ffdf-40eb-9067-78b9ae6e7919';
advertiseStart(uuid);

advertiseStart();

Stop advertising

advertiseStop();

Scanner

Import the modules

import {
  BlePhoneToPhoneEvent,
  scanStart,
  scanStop,
} from 'react-native-ble-phone-to-phone'
import { NativeEventEmitter, NativeModules } from 'react-native';

Register a listener to collect the devices through ReactNative events.

const eventEmitter = new NativeEventEmitter(NativeModules.BLEAdvertiser);
eventEmitter.addListener('foundUuid', (data) => {
  console.log('> foundUuid data : ', data)   // found uuid
});
eventEmitter.addListener('foundDevice', (data) =>
  console.log('> foundDevice data : ', data) // found device
);
eventEmitter.addListener('error', (error) =>
  console.log('> error : ', error)           // error message
);
eventEmitter.addListener('log', (log) =>
  console.log('> log : ', log)               // log message
);

Start scanning with uuid array of strings

const uuids = [
  '26f08670-ffdf-40eb-9067-78b9ae6e7919',
  '342730d1-9221-4da0-ab8b-bbd7da07ca62',
];
scanStart(uuids.join());  

If you need to scan all the nearby devices, Start scanning without uuid array

scanStart();  

Stop scanning

scanStop();

About

A very simple Bluetooth advertiser and scanner for React Native.

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published