# flutter_blue_plus **Repository Path**: gumpyang/flutter_blue_plus ## Basic Information - **Project Name**: flutter_blue_plus - **Description**: 在尝试这个组件时发现一直有不需要的调试信息，所以自己分支一个 - **Primary Language**: Dart - **License**: BSD-3-Clause - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 2 - **Forks**: 0 - **Created**: 2022-03-13 - **Last Updated**: 2024-04-25 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README [![pub package](https://img.shields.io/pub/v/flutter_blue_plus.svg)](https://pub.dartlang.org/packages/flutter_blue_plus)

FlutterBlue

## Introduction FlutterBluePlus is a bluetooth plugin for [Flutter](https://flutter.dev), a new app SDK to help developers build modern multi-platform apps. Note: this plugin is continuous work from FlutterBlue since maintaince stoped. ## Alpha version **This package must be tested on a real device.** ## Cross-Platform Bluetooth LE FlutterBluePlus aims to offer the most from both platforms (iOS and Android). Using the FlutterBluePlus instance, you can scan for and connect to nearby devices ([BluetoothDevice](#bluetoothdevice-api)). Once connected to a device, the BluetoothDevice object can discover services ([BluetoothService](lib/src/bluetooth_service.dart)), characteristics ([BluetoothCharacteristic](lib/src/bluetooth_characteristic.dart)), and descriptors ([BluetoothDescriptor](lib/src/bluetooth_descriptor.dart)). The BluetoothDevice object is then used to directly interact with characteristics and descriptors. ## Usage ### Obtain an instance ```dart FlutterBluePlus flutterBlue = FlutterBluePlus.instance; ``` ### Scan for devices ```dart // Start scanning flutterBlue.startScan(timeout: Duration(seconds: 4)); // Listen to scan results var subscription = flutterBlue.scanResults.listen((results) { // do something with scan results for (ScanResult r in results) { print('${r.device.name} found! rssi: ${r.rssi}'); } }); // Stop scanning flutterBlue.stopScan(); ``` ### Connect to a device ```dart // Connect to the device await device.connect(); // Disconnect from device device.disconnect(); ``` ### Discover services ```dart List services = await device.discoverServices(); services.forEach((service) { // do something with service }); ``` ### Read and write characteristics ```dart // Reads all characteristics var characteristics = service.characteristics; for(BluetoothCharacteristic c in characteristics) { List value = await c.read(); print(value); } // Writes to a characteristic await c.write([0x12, 0x34]) ``` ### Read and write descriptors ```dart // Reads all descriptors var descriptors = characteristic.descriptors; for(BluetoothDescriptor d in descriptors) { List value = await d.read(); print(value); } // Writes to a descriptor await d.write([0x12, 0x34]) ``` ### Set notifications and listen to changes ```dart await characteristic.setNotifyValue(true); characteristic.value.listen((value) { // do something with new value }); ``` ### Read the MTU and request larger size ```dart final mtu = await device.mtu.first; await device.requestMtu(512); ``` Note that iOS will not allow requests of MTU size, and will always try to negotiate the highest possible MTU (iOS supports up to MTU size 185) ## Getting Started ### Change the minSdkVersion for Android flutter_blue_plus is compatible only from version 19 of Android SDK so you should change this in **android/app/build.gradle**: ```dart Android { defaultConfig { minSdkVersion: 19 ``` ### Add permissions for Bluetooth We need to add the permission to use Bluetooth and access location: #### **Android** In the **android/app/src/main/AndroidManifest.xml** let’s add: ```xml