THIS IS A FORK VERSION OF FLUTTER_BLUE(这是一个 fork 版本，使用前请注意！)

Introduction

Alpha version

Cross-Platform Bluetooth LE

Usage

Obtain an instance

FlutterBlue flutterBlue=FlutterBlue.instance;

Scan for devices

// Start scanningflutterBlue.startScan(timeout:Duration(seconds:4));// Listen to scan resultsvar subscription= flutterBlue.scanResults.listen((results) {// do something with scan resultsfor (ScanResult rin results) {print('${r.device.name} found! rssi: ${r.rssi}');    }});// Stop scanningflutterBlue.stopScan();

Connect to a device

// Connect to the deviceawait device.connect();// Disconnect from devicedevice.disconnect();

Discover services

List<BluetoothService> services=await device.discoverServices();services.forEach((service) {// do something with service});

Read and write characteristics

// Reads all characteristicsvar characteristics= service.characteristics;for(BluetoothCharacteristic cin characteristics) {List<int> value=await c.read();print(value);}// Writes to a characteristicawait c.write([0x12,0x34])

Read and write descriptors

// Reads all descriptorsvar descriptors= characteristic.descriptors;for(BluetoothDescriptor din descriptors) {List<int> value=await d.read();print(value);}// Writes to a descriptorawait d.write([0x12,0x34])

Set notifications and listen to changes

await characteristic.setNotifyValue(true);characteristic.value.listen((value) {// do something with new value});

Read the MTU and request larger size

final mtu=await device.mtu.first;await device.requestMtu(512);

Getting Started

Change the minSdkVersion for Android

Android {  defaultConfig {     minSdkVersion:19

Add permissions for Bluetooth

Android

<!-- Request legacy Bluetooth permissions on older devices.-->    <uses-permissionandroid:name="android.permission.BLUETOOTH"android:maxSdkVersion="30" />    <uses-permissionandroid:name="android.permission.BLUETOOTH_ADMIN"android:maxSdkVersion="30" />    <uses-permissionandroid:name="android.permission.FOREGROUND_SERVICE" />    <uses-permissionandroid:name="android.permission.ACCESS_BACKGROUND_LOCATION"/><!-- Needed only if your app looks for Bluetooth devices.         You must add an attribute to this permission, or declare the         ACCESS_FINE_LOCATION permission, depending on the results when you         check location usage in your app.-->    <uses-permissionandroid:name="android.permission.BLUETOOTH_SCAN" /><!-- Needed only if your app makes the device discoverable to Bluetooth         devices.-->    <uses-permissionandroid:name="android.permission.BLUETOOTH_ADVERTISE" /><!-- Needed only if your app communicates with already-paired Bluetooth         devices.-->    <uses-permissionandroid:name="android.permission.BLUETOOTH_CONNECT" /> <application

IOS

<dict><key>NSBluetoothAlwaysUsageDescription</key><string>NeedBLE permission</string><key>NSBluetoothPeripheralUsageDescription</key><string>NeedBLE permission</string><key>NSLocationAlwaysAndWhenInUseUsageDescription</key><string>NeedLocation permission</string><key>NSLocationAlwaysUsageDescription</key><string>NeedLocation permission</string><key>NSLocationWhenInUseUsageDescription</key><string>NeedLocation permission</string>

Reference

FlutterBlue API

BluetoothDevice API

BluetoothCharacteristic API

BluetoothDescriptor API

Troubleshooting

When I scan using a service UUID filter, it doesn't find any devices.