Flutter BLE应用的开发-flutter_blue
Posted Andy__Wu
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Flutter BLE应用的开发-flutter_blue相关的知识，希望对你有一定的参考价值。
一、写在前面的话
本文主要介绍在Flutter环境下开发BLE应用。主要包含以下内容：判断蓝牙是否开启、判断是否有位置权限、扫描设备、
连接设备、监听设备上报的数据（Notify）、向设备发送数据、监听设备的断开等。内容虽然简单，但是很详细。
二、开始
1、使用到的库
flutter_blue: ^0.7.1+1
permission_handler: "^3.2.0" # 权限
众所周知，Flutter要使用原生的能力，就需要有原生库的支持，这里我们使用了flutter_blue来开发跟BLE相关的功能，permission_handler来开发权限检测以及申请权限的功能。在使用flutter_blue开启扫描的时候，插件会弹出系统的权限申请窗口，但是点击授权以后报了一个空指针，可能是插件存在的一个BUG，所以这里我们用permission_handler插件来处理权限相关的问题。（友情提示：在android上扫描Ble需要位置权限）
2、flutter_blue的用法
import 'package:flutter_blue/flutter_blue.dart';
FlutterBlue flutterBlue = FlutterBlue.instance;
导包和初始化。
3、判断蓝牙是否开启
@override
void initState() {
super.initState();
flutterBlue.state.listen((state){
if(state == BluetoothState.on){
print('蓝牙状态为开启');
isBleOn = true;
}else if(state == BluetoothState.off){
print('蓝牙状态为关闭');
isBleOn = false;
}
});
}
在路由初始化的时候开启对蓝牙状态的监听。
if(!isBleOn){
ToastUtils.toast(context, "手机蓝牙未打开，请打开后再扫描设备");
return;
}
在开始之前对蓝牙开启状态进行判断。
4、判断位置权限
PermissionUtils.checkPermissions(PermissionGroup.location).then((v) {
if (v) {
Navigator.pushNamed(context, "/device_page");
} else {
PermissionUtils.showDialog(context, "提示", "扫描蓝牙需要位置权限", () async {
Navigator.pop(context);
await PermissionHandler()
.requestPermissions([PermissionGroup.location]);
PermissionStatus permission = await PermissionHandler()
.checkPermissionStatus(PermissionGroup.location);
if (permission == PermissionStatus.granted) {
Navigator.pushNamed(context, "/device_page");
} else {
print("no Permission to scan ble");
ToastUtils.toast(context, "权限开启失败，请在系统设置中开启！");
}
}, () {
Navigator.pop(context);
});
}
});
以上是对位置权限的处理，如果有，就进入扫描设备页面，没有的话申请权限，申请完之后在对其进行判断。因为本文的重点是ble，这里不对权限申请插件做过多的介绍。（PermissionUtils，dialog的源码会在文末附上）
5、扫描设备
flutterBlue.scan().listen((scanResult) {
// do something with scan result
var device = scanResult.device;
if (device.name.length > 10) {
if (deviceSet.indexOf(device) == -1) {
setState(() {
deviceSet.add(device);
});
}
print(
'${device.name} found! rssi: ${scanResult.rssi},address:${device.id}');
}
});
使用api进行ble扫描，我对蓝牙名进行了过滤，记得要存起来哦，连接的时候要用的。
6、连接设备
await device.connect(autoConnect: false, timeout: Duration(seconds: 10));
这里的连接参数可以根据需要自己进行设置，我这里设置了10秒连接超时。这里我们一般还不能认为连接成功，还需要找到对应的读写服务和特征值。
BluetoothCharacteristic mCharacteristic;
List<BluetoothService> services = await device.discoverServices();
services.forEach((service) {
if (service.uuid.toString() == GattAttributes.BLE_SPP_SERVICE_READ) {
List<BluetoothCharacteristic> characteristics =
service.characteristics;
characteristics.forEach((characteristic) {
if (characteristic.uuid.toString() ==
GattAttributes.BLE_SPP_NOTIFY_CHARACTERISTIC) {
mCharacteristic = characteristic;
}
});
}
// do something with service
});
以上便是根据uuid在对应的读写服务中找到对应Characteristic，至此，连接过程便已经完成了，可以进行页面跳转了。
7、读取设备的心跳
if (mNotifyCharacteristic != null) {
mNotifyCharacteristic.setNotifyValue(true);
mNotifyCharacteristic.value
.listen((value) => {print("device is online: " + value.toString())});
}
通过第6点的方法，找到可以notify的Characteristic，开启notify，然后监听其值。这里的setNotifyValue可能会有异常，具体请
参考我的前篇文章点我点我。下图是蓝牙设备传回的心跳。
8、向设备发送数据
Future<Null> write(List<int> value, {bool withoutResponse = false})
我先查看源码可知write方法的参数是一个int型的list，那么我们只需把我们需要发送的数据放进这个list中就行了。
mWriteCharacteristic.write([0x00,0x01]);
同样，获取mWriteCharacteristic的方法如上第6点所示。
9、监听设备的断开
device.state.listen((state){
if(state == BluetoothDeviceState.disconnected){
DialogUtils.showOneDialog(context, "提示", "设备已断开连接", (){
//do something
});
}
});
10、在不用页面获取device
await flutterBlue.connectedDevices.then((list) => {
if (list.length == 0) {Navigator.pop(context)} else {device = list[0]}
});
在不同的页面（路由）需要对设备进行读写操作，在设备的连接池中获取。
三、总结
本文归纳了flutter下使用ble对设备进行读写的详细步骤以及一些基本方法和注意事项，如果有问题的同学欢迎留言，博主会一一解答的。技术在于分享，开源的乐趣也在于此，如果本文有不够严谨的地方还望大佬支持。
附录
import 'package:flutter/cupertino.dart';
class DialogUtils{
static showDialog(BuildContext cxt, String title, String content,
ok(), cancel()) {
showCupertinoDialog<int>(
context: cxt,
builder: (cxt) {
return CupertinoAlertDialog(
title: Text(title),
content: Text(content),
actions: <Widget>[
CupertinoDialogAction(
child: Text("确定"),
onPressed: () {
ok();
},
),
CupertinoDialogAction(
child: Text("取消"),
onPressed: () {
cancel();
},
)
],
);
});
}
static showOneDialog(BuildContext cxt, String title, String content,
ok()) {
showCupertinoDialog<int>(
context: cxt,
builder: (cxt) {
return CupertinoAlertDialog(
title: Text(title),
content: Text(content),
actions: <Widget>[
CupertinoDialogAction(
child: Text("确定"),
onPressed: () {
ok();
},
)
],
);
});
}
}
import 'package:flutter/cupertino.dart';
import 'package:permission_handler/permission_handler.dart';
/// 权限管理工具类
class PermissionUtils {
/// 检测相关权限是否已经打开(根据已有状态值)
static bool checkPermissionsByStatus(List<PermissionStatus> lists) {
bool result = true;
for (PermissionStatus permissionStatus in lists) {
if (permissionStatus != PermissionStatus.granted) {
result = false;
break;
}
}
return result;
}
/// 检测相关权限是否已经打开（根据已有权限名称）
static Future<bool> checkPermissionsByGroup(
List<PermissionGroup> lists) async {
bool result = true;
for (PermissionGroup permissionGroup in lists) {
PermissionStatus checkPermissionStatus =
await PermissionHandler().checkPermissionStatus(permissionGroup);
if (checkPermissionStatus != PermissionStatus.granted) {
result = false;
break;
}
}
return result;
}
static Future<bool> checkPermissions(PermissionGroup permissionGroup) async{
bool result = true;
PermissionStatus checkPermissionStatus =
await PermissionHandler().checkPermissionStatus(permissionGroup);
if (checkPermissionStatus != PermissionStatus.granted) {
result = false;
}
return result;
}
/// 权限提示对话款
static showDialog(BuildContext cxt, String title, String content,
ok(), cancel()) {
showCupertinoDialog<int>(
context: cxt,
builder: (cxt) {
return CupertinoAlertDialog(
title: Text(title),
content: Text(content),
actions: <Widget>[
CupertinoDialogAction(
child: Text("去开启"),
onPressed: () {
ok();
},
),
CupertinoDialogAction(
child: Text("取消"),
onPressed: () {
cancel();
},
)
],
);
});
}
}
以上是关于Flutter BLE应用的开发-flutter_blue的主要内容，如果未能解决你的问题，请参考以下文章