react-native-ble-manager
Advanced tools
This is a porting of https://github.com/don/cordova-plugin-ble-central project to React Native.
RN 0.40+
RN 0.30-0.39 supported until 2.4.3
npm i --save react-native-ble-manager
After installing, you need to link the native library. You can either:
react-native link, orBoth approaches are described below.
react-native linkreact-native link react-native-ble-manager
After this step:
android/app/build.gradle:// file: android/app/build.gradle
...
android {
...
defaultConfig {
...
minSdkVersion 19 // <--- make sure this is 19 or greater
...
}
...
}
// file: android/settings.gradle
...
include ':react-native-ble-manager'
project(':react-native-ble-manager').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-ble-manager/android')
// file: android/app/build.gradle
...
android {
...
defaultConfig {
...
minSdkVersion 19 // <--- make sure this is 19 or greater
...
}
...
}
dependencies {
...
compile project(':react-native-ble-manager')
}
// file: android/app/src/main/AndroidManifest.xml
...
<uses-permission android:name="android.permission.BLUETOOTH"/>
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
...
...
import it.innove.BleManagerPackage; // <--- import
public class MainApplication extends Application implements ReactApplication {
...
@Override
protected List<ReactPackage> getPackages() {
return Arrays.<ReactPackage>asList(
new MainReactPackage(),
new BleManagerPackage() // <------ add the package
);
}
...
}
start method before anything.retrieveServices methodThe easiest way to test is simple make your AppRegistry point to our example component, like this:
// in your index.ios.js or index.android.js
import React, { Component } from 'react';
import {
AppRegistry,
} from 'react-native';
import App from 'react-native-ble-manager/example/App' //<-- simply point to the example js!
AppRegistry.registerComponent('MyAwesomeApp', () => App);
Or, you can still look into the whole example folder for a standalone project.
Init the module.
Returns a Promise object.
Don't call this multiple times.
Arguments
options - JSONThe parameter is optional the configuration keys are:
showAlert - Boolean - [iOS only] Show or hide the alert if the bluetooth is turned off during initializationrestoreIdentifierKey - String - [iOS only] Unique key to use for CoreBluetooth state restorationforceLegacy - Boolean - [Android only] Force to use the LegacyScanManagerExamples
BleManager.start({showAlert: false})
.then(() => {
// Success code
console.log('Module initialized');
});
Scan for availables peripherals.
Returns a Promise object.
Arguments
serviceUUIDs - Array of String - the UUIDs of the services to looking for. On Android the filter works only for 5.0 or newer.seconds - Integer - the amount of seconds to scan.allowDuplicates - Boolean - [iOS only] allow duplicates in device scanningscanningOptions - JSON - [Android only] after Android 5.0, user can control specific ble scan behaviors:
numberOfMatches - Number - corresponding to setNumOfMatchesmatchMode - Number - corresponding to setMatchModescanMode - Number - corresponding to setScanModeExamples
BleManager.scan([], 5, true)
.then(() => {
// Success code
console.log('Scan started');
});
Stop the scanning.
Returns a Promise object.
Examples
BleManager.stopScan()
.then(() => {
// Success code
console.log('Scan stopped');
});
Attempts to connect to a peripheral. In many case if you can't connect you have to scan for the peripheral before.
Returns a Promise object.
Arguments
peripheralId - String - the id/mac address of the peripheral to connect.Examples
BleManager.connect('XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX')
.then(() => {
// Success code
console.log('Connected');
})
.catch((error) => {
// Failure code
console.log(error);
});
Disconnect from a peripheral.
Returns a Promise object.
Arguments
peripheralId - String - the id/mac address of the peripheral to disconnect.Examples
BleManager.disconnect('XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX')
.then(() => {
// Success code
console.log('Disconnected');
})
.catch((error) => {
// Failure code
console.log(error);
});
Create the request to the user to activate the bluetooth.
Returns a Promise object.
Examples
BleManager.enableBluetooth()
.then(() => {
// Success code
console.log('The bluetooh is already enabled or the user confirm');
})
.catch((error) => {
// Failure code
console.log('The user refuse to enable bluetooth');
});
Force the module to check the state of BLE and trigger a BleManagerDidUpdateState event.
Examples
BleManager.checkState();
Start the notification on the specified characteristic, you need to call retrieveServices method before.
Returns a Promise object.
Arguments
peripheralId - String - the id/mac address of the peripheral.serviceUUID - String - the UUID of the service.characteristicUUID - String - the UUID of the characteristic.Examples
BleManager.startNotification('XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX')
.then(() => {
// Success code
console.log('Notification started');
})
.catch((error) => {
// Failure code
console.log(error);
});
Stop the notification on the specified characteristic.
Returns a Promise object.
Arguments
peripheralId - String - the id/mac address of the peripheral.serviceUUID - String - the UUID of the service.characteristicUUID - String - the UUID of the characteristic.Read the current value of the specified characteristic, you need to call retrieveServices method before.
Returns a Promise object.
Arguments
peripheralId - String - the id/mac address of the peripheral.serviceUUID - String - the UUID of the service.characteristicUUID - String - the UUID of the characteristic.Examples
BleManager.read('XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX')
.then((readData) => {
// Success code
console.log('Read: ' + readData);
const buffer = Buffer.Buffer.from(readData); //https://github.com/feross/buffer#convert-arraybuffer-to-buffer
const sensorData = buffer.readUInt8(1, true);
})
.catch((error) => {
// Failure code
console.log(error);
});
Write with response to the specified characteristic, you need to call retrieveServices method before.
Returns a Promise object.
Arguments
peripheralId - String - the id/mac address of the peripheral.serviceUUID - String - the UUID of the service.characteristicUUID - String - the UUID of the characteristic.data - Byte array - the data to write.maxByteSize - Integer - specify the max byte size before splitting messageData preparation
If your data is not in byte array format you should convert it first. For strings you can use convert-string or other npm package in order to achieve that.
Install the package first:
npm install convert-string
Then use it in your application:
// Import/require in the beginning of the file
import { stringToBytes } from 'convert-string';
// Convert data to byte array before write/writeWithoutResponse
const data = stringToBytes(yourStringData);
Feel free to use other packages or google how to convert into byte array if your data has other format.
Examples
BleManager.write('XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', data)
.then(() => {
// Success code
console.log('Write: ' + data);
})
.catch((error) => {
// Failure code
console.log(error);
});
Write without response to the specified characteristic, you need to call retrieveServices method before.
Returns a Promise object.
Arguments
peripheralId - String - the id/mac address of the peripheral.serviceUUID - String - the UUID of the service.characteristicUUID - String - the UUID of the characteristic.data - Byte array - the data to write.maxByteSize - Integer - (Optional) specify the max byte sizequeueSleepTime - Integer - (Optional) specify the wait time before each write if the data is greater than maxByteSizeData preparation
If your data is not in byte array format check info for the write function above.
Example
BleManager.writeWithoutResponse('XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', data)
.then(() => {
// Success code
console.log('Writed: ' + data);
})
.catch((error) => {
// Failure code
console.log(error);
});
Read the current value of the RSSI.
Returns a Promise object.
Arguments
peripheralId - String - the id/mac address of the peripheral.Examples
BleManager.readRSSI('XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX')
.then((rssi) => {
// Success code
console.log('Current RSSI: ' + rssi);
})
.catch((error) => {
// Failure code
console.log(error);
});
Request an MTU size used for a given connection.
Returns a Promise object.
Arguments
peripheralId - String - the id/mac address of the peripheral.mtu - Integer - the MTU size to be requested in bytes.Examples
BleManager.requestMTU('XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', 512)
.then(() => {
// Success code
console.log('MTU size changed');
})
.catch((error) => {
// Failure code
console.log(error);
});
Retrieve the peripheral's services and characteristics.
Returns a Promise object.
Arguments
peripheralId - String - the id/mac address of the peripheral.Examples
BleManager.retrieveServices('XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX')
.then((peripheralInfo) => {
// Success code
console.log('Peripheral info:', peripheralInfo);
});
Return the connected peripherals.
Returns a Promise object.
Arguments
serviceUUIDs - Array of String - the UUIDs of the services to looking for.Examples
BleManager.getConnectedPeripherals([])
.then((peripheralsArray) => {
// Success code
console.log('Connected peripherals: ' + peripheralsArray.length);
});
Start the bonding (pairing) process with the remote device.
Returns a Promise object. The promise is resolved when either new bond successfully created or bond already existed, otherwise it will be rejected.
Examples
BleManager.createBond(peripheralId)
.then(() => {
console.log('createBond success or there is already an existing one');
})
.catch(() => {
console.log('fail to bond');
})
Return the bonded peripherals.
Returns a Promise object.
Examples
BleManager.getBondedPeripherals([])
.then((bondedPeripheralsArray) => {
// Each peripheral in returned array will have id and name properties
console.log('Bonded peripherals: ' + bondedPeripheralsArray.length);
});
Return the discovered peripherals after a scan.
Returns a Promise object.
Examples
BleManager.getDiscoveredPeripherals([])
.then((peripheralsArray) => {
// Success code
console.log('Discovered peripherals: ' + peripheralsArray.length);
});
Removes a disconnected peripheral from the cached list.
It is useful if the device is turned off, because it will be re-discovered upon turning on again.
Returns a Promise object.
Arguments
peripheralId - String - the id/mac address of the peripheral.Check whether a specific peripheral is connected and return true or false.
Returns a Promise object.
Examples
BleManager.isPeripheralConnected('XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', [])
.then((isConnected) => {
if (isConnected) {
console.log('Peripheral is connected!');
} else {
console.log('Peripheral is NOT connected!');
}
});
The scanning for peripherals is ended.
Arguments
noneExamples
bleManagerEmitter.addListener(
'BleManagerStopScan',
() => {
// Scanning is stopped
}
);
The BLE change state.
Arguments
state - String - the new BLE state ('on'/'off').Examples
bleManagerEmitter.addListener(
'BleManagerDidUpdateState',
(args) => {
// The new state: args.state
}
);
The scanning find a new peripheral.
Arguments
id - String - the id of the peripheralname - String - the name of the peripheralrssi - Number - the RSSI valueadvertising - JSON - the advertising payload, according to platforms:
bytes and data (Base64 encoded string)kCBAdvDataChannel - NumberkCBAdvDataIsConnectable - NumberkCBAdvDataLocalName - StringkCBAdvDataManufacturerData - JSON - contains the raw bytes and data (Base64 encoded string)Examples
bleManagerEmitter.addListener(
'BleManagerDiscoverPeripheral',
(args) => {
// The id: args.id
// The name: args.name
}
);
A characteristic notify a new value.
Arguments
peripheral - String - the id of the peripheralcharacteristic - String - the UUID of the characteristicvalue - Array - the read valueA peripheral was connected.
Arguments
peripheral - String - the id of the peripheralA peripheral was disconnected.
Arguments
peripheral - String - the id of the peripheralFAQs
A BLE module for react native.
The npm package react-native-ble-manager receives a total of 36,267 weekly downloads. As such, react-native-ble-manager popularity was classified as popular.
We found that react-native-ble-manager demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Company News
Socket is joining TC54 to help develop standards for software supply chain security, contributing to the evolution of SBOMs, CycloneDX, and Package URL specifications.
Security News
PyPI now allows maintainers to archive projects, improving security and helping users make informed decisions about their dependencies.
Research
Security News
Malicious npm package postcss-optimizer delivers BeaverTail malware, targeting developer systems; similarities to past campaigns suggest a North Korean connection.