flutter_blue 0.0.1 flutter_blue: ^0.0.1 copied to clipboard
Bluetooth plugin for Flutter
Introduction #
FlutterBlue is a bluetooth plugin for Flutter, a new mobile SDK to help developers build modern apps for iOS and Android.
Cross-Platform Bluetooth LE #
FlutterBlue aims to offer the most from both platforms (iOS and Android).
Using the FlutterBlue instance, you can scan for and connect to nearby devices (BluetoothDevice). Once connected to a device, the BluetoothDevice object can discover services (BluetoothService), characteristics (BluetoothCharacteristic), and descriptors (BluetoothDescriptor). The BluetoothDevice object is then used to directly interact with characteristics and descriptors.
FlutterBlue API #
Android | iOS | Description | |
---|---|---|---|
startScan | ✅ | ⬜ | Starts a scan for Bluetooth Low Energy devices. |
stopScan | ✅ | ⬜ | Stops a scan for Bluetooth Low Energy devices. |
connect | ✅ | ⬜ | Establishes a connection to the Bluetooth Device. |
cancelConnection | ✅ | ⬜ | Cancels a connection to the Bluetooth Device. |
state | ✅ | ⬜ | Gets the current state of the Bluetooth Adapter. |
onStateChanged | ✅ | ⬜ | Stream of state changes for the Bluetooth Adapter. |
BluetoothDevice API #
Android | iOS | Description | |
---|---|---|---|
discoverServices | ✅ | ⬜ | Discovers services offered by the remote device as well as their characteristics and descriptors. |
services | ✅ | ⬜ | Gets a list of services. Requires that discoverServices() has completed. |
readCharacteristic | ✅ | ⬜ | Retrieves the value of a specified characteristic. |
readDescriptor | ✅ | ⬜ | Retrieves the value of a specified descriptor. |
writeCharacteristic | ✅ | ⬜ | Writes the value of a characteristic. |
writeDescriptor | ✅ | ⬜ | Writes the value of a descriptor. |
setNotifyValue | ⬜ | ⬜ | Sets notifications or indications for the value of a specified characteristic. |
canSendWriteWithoutResponse | ⬜ | ⬜ | Indicates whether the Bluetooth Device can send a write without response. |
state | ⬜ | ⬜ | Gets the current state of the Bluetooth Device. |
onStateChanged | ⬜ | ⬜ | Stream of state changes for the Bluetooth Device. |