flutter之玩转蓝牙插件flutter_blue 0.6.0+1-第一篇

介绍

FlutterBlue是一款flutter对蓝牙插件,旨在提供来自两个平台（iOS和Android）的最大功能。 使用FlutterBlue实例，您能够扫描并链接到附近的设备（BluetoothDevice）。一旦链接到设备，BluetoothDevice对象就能够发现服务（BluetoothService），特征（BluetoothCharacteristic）和描述符（BluetoothDescriptor）。而后，BluetoothDevice对象用于直接与特征和描述符交互。

基本用法

生成实例

FlutterBlue flutterBlue = FlutterBlue.instance;
复制代码

扫描设备操做

/// 使用实例方法scan(),并使用listen()监听，scanResult作参数
var scanSubscription = flutterBlue.scan().listen((scanResult) {
    // do something with scan result
    device = scanResult.device;
    print('${device.name} found! rssi: ${scanResult.rssi}');
});

/// 关闭扫描操做，避免内存泄漏
scanSubscription.cancel();
复制代码

链接设备

/// Connect to the device 这是一个异步操做
await device.connect();

/// Disconnect from device
device.disconnect();
复制代码

搜索设备

//异步搜索方法，返回BluetoothService对列表
List<BluetoothService> services = await device.discoverServices();
    //遍历蓝牙设备对列表
services.forEach((service) {
    // do something with service
});
复制代码

读写特征值characteristics

相信有些小伙伴不太了解characteristics是干什么用的，BLE的基本关系是：
一个蓝牙4.0的终端device能够包含多个Service，
一个Service能够包含多个Characteristic，一个Characteristic包含一个Value和多个Descriptor，
一个Descriptor包含一个Value。
简单的说蓝牙设备正是经过Characteristic来进行设备间的交互的(如读、写、订阅等操做)，
详细介绍能够参考 [https://www.jianshu.com/p/d991f0fdec63]
复制代码

// 经过设备读取全部特征值characteristics，返回列表
var characteristics = service.characteristics;
for(BluetoothCharacteristic c in characteristics) {
    List<int> value = await c.read();
    print(value);
}

// 异步方法，向一个特征值characteristic写入数据
await c.write([0x12, 0x34])
复制代码

读写描述符descriptors

// 经过特征值读取全部描述符descriptors，返回列表
var descriptors = characteristic.descriptors;
for(BluetoothDescriptor d in descriptors) {
    List<int> value = await d.read();
    print(value);
}

// 异步方法，向一个特征值descriptors写入数据
await d.write([0x12, 0x34])
复制代码

设置通知和监听特征值characterisic的value变化

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

经常使用API

FlutterBlue API

	Android	iOS	Description
scan	:white_check_mark:	:white_check_mark:	开始蓝牙低功耗设备的扫描
state	:white_check_mark:	:white_check_mark:	获取蓝牙适配器的当前状态
onStateChanged	:white_check_mark:	:white_check_mark:	蓝牙适配器的状态变化流

BluetoothDevice API

	Android	iOS	Description
connect	:white_check_mark:	:white_check_mark:	创建设备链接
disconnect	:white_check_mark:	:white_check_mark:	取消一个激活active的或者挂起pending的设备device链接
discoverServices	:white_check_mark:	:white_check_mark:	经过提供的远程设备device尽量的搜索服务services,及它的特征值characteristics和描述符descriptors
services	:white_check_mark:	:white_check_mark:	获取设备device列表，要求discoverServices()已经执行完成.
state	:white_check_mark:	:white_check_mark:	获取设备的当前状态.
onStateChanged	:white_check_mark:	:white_check_mark:	监听设备状态改变的回调

BluetoothCharacteristic API

	Android	iOS	Description
read	:white_check_mark:	:white_check_mark:	检索特征值characteristic的value
write	:white_check_mark:	:white_check_mark:	写入修改特征值characteristic的value.
setNotifyValue	:white_check_mark:	:white_check_mark:	设置特征值characteristic的通知和指示.
value	:white_check_mark:	:white_check_mark:	当发生改变时，特征值characteristic的value流.

BluetoothDescriptor API

	Android	iOS	Description
read	:white_check_mark:	:white_check_mark:	检索描述符descriptor的value.
write	:white_check_mark:	:white_check_mark:	写入修改描述符descriptor的value.