A ble library with wechat api style for flutter.
微信api风格的蓝牙库
加入依赖:
flutter_wechat_ble: any
导入
import 'package:flutter_wechat_ble/flutter_wechat_ble.dart';
参考下面的文档，因为语言不一样，所以在调用上略有区别:
https://developers.weixin.qq.com/miniprogram/dev/api/wx.readBLECharacteristicValue.html
在使用本库的时候，所有的错误都可以使用如下的形式来捕获
try {
await FlutterWechatBle.someMethod();
} on BleError catch (e) {
//// 这里捕获了BleError，表示蓝牙操作发生了异常
print("错误码 ${e.code} 错误信息 ${e.message}");
}
具体的错误码含义如下:
String get message {
switch (code) {
case "10000":
return "openBluetoothAdapter not called yet!";
case "10001":
return "Bluetooth is not opened!";
case "10002":
return "Cannot find device id ";
case "10003":
return "Connection fail";
case "10004":
return "Cannot find service";
case "10005":
return "CHARACTERISTIC not found";
case "10006":
return "No connection found";
case "10007":
return "Property not support";
case "10008":
return "System error!";
}
}
这里的错误码定义与微信小程序的错误定义一致，也可以参考这里: https://developers.weixin.qq.com/miniprogram/dev/api/wx.readBLECharacteristicValue.html
ios需要注意的是在info.plist中增加权限:
<key>NSBluetoothPeripheralUsageDescription</key>
<string>请求访问蓝牙</string>
static FlutterWechatBle.getBluetoothAdapterState()
await FlutterWechatBle.openBluetoothAdapter();
注意本库并不对权限做出检查。
await FlutterWechatBle.closeBluetoothAdapter();
await FlutterWechatBle.startBluetoothDevicesDiscovery();
FlutterWechatBle.onBluetoothDeviceFound((BleDevice device){
//找到了一个外设
});
BleDevice为扫描的结果，包含一个设备的描述信息
/// uuid of the device
final String deviceId;
/// device name
final String name;
/// RSSI
final String RSSI;
如果不想监听，则调用
FlutterWechatBle.onBluetoothDeviceFound(null)
将监听函数设置null即可
发现的设备将在再次调用startBluetoothDevicesDiscovery后被清空
await FlutterWechatBle.getBluetoothDevices();
await FlutterWechatBle.getConnectedBluetoothDevices();
await FlutterWechatBle.stopBluetoothDevicesDiscovery();
await FlutterWechatBle.createBLEConnection(deviceId: device.deviceId)
这里的deviceId为上面的监听函数结果BleDevice的一个属性
await FlutterWechatBle.closeBLEConnection(deviceId: device.deviceId);
FlutterWechatBle.onBLEConnectionStateChange((String deviceId,bool connected){
});
停止监听外设连接状态:
FlutterWechatBle.onBLEConnectionStateChange(null);
List<BleService> services = await FlutterWechatBle.getBLEDeviceServices(deviceId: device.deviceId);
BleService的属性:
/// uuid of the service
final String uuid;
/// always true in android and the `isPrimary` field of the class `CBService` in ios
final bool isPrimary;
Future<List<BleCharacteristic>> characteristics = await FlutterWechatBle.getBLEDeviceCharacteristics(
deviceId: device.deviceId, serviceId: service.uuid));
参数分别为:deviceId和serviceId,
serviceId为上面BleService的字段uuid
BleCharacteristic的属性:
/// uuid of the characteristic
final String uuid;
/// support read
final bool read;
/// support write
final bool write;
/// support notify
final bool notify;
/// support indicate
final bool indicate;
与小程序略有区别，将属性直接放在BleCharacteristic这个类下面，使用更加方便
await FlutterWechatBle.notifyBLECharacteristicValueChange(
deviceId: device.deviceId,
serviceId: service.uuid,
characteristicId: characteristic.uuid,
state: true)
注意这个方法只能用于支持notify的特征调用。
await FlutterWechatBle.writeBLECharacteristicValue(
deviceId: device.deviceId,
serviceId: service.uuid,
characteristicId: characteristic.uuid,
value: 写入值的十六进制字符串或者十六进制数组);
这里的value可以为List 或者 十六进制字符串,如果对这些概念不熟悉，可以参考这里：
https://baike.baidu.com/item/%E5%8D%81%E5%85%AD%E8%BF%9B%E5%88%B6/4162457?fr=aladdin
BleValue value = await FlutterWechatBle.readBLECharacteristicValue(
deviceId: device.deviceId,
serviceId: service.uuid,
characteristicId: characteristic.uuid
)
BleValue的属性:
final String deviceId;
final String serviceId;
final String characteristicId;
final String value;
这里的value为十六进制字符串，如果要得到十六进制数组,则可以使用
value.bytes
FlutterWechatBle.onBLECharacteristicValueChange((BleValue value){
});
如果需要停止监听:
FlutterWechatBle.onBLECharacteristicValueChange(null)
设置为null即可
一问一答式的通信方式指的是将蓝牙设备当成一台服务器来看，当app发送一个设备支持的指令给设备的时候，设备将会通过通知的方式返回一个响应。 这个过程，对于大部分蓝牙设备都是通用的。
其中的一问一答式，我们可以将之封装起来，通过设备配置类，封装数据包的组装和处理的方式，大大减少实际的开发工作量。
目前在代码中放了一个实际的设备,具体可以看这里:
其中将搜索设备、连接设备、发现服务、发现特征、设置通知、写入和获取数据统一封装起来。将这些复杂的操作转成标准的流程， 并且可以支持连接多种设备，管理多个设备的连接。并将通知型的消息获取过程，改造成发送消息后可以直接使用await等待数据返回， 将原来的非线性流程改成如丝滑般柔顺的线性流程。
下面的代码演示:
static DeviceConfig config = new TbkDeviceConfig();
static BluetoothService bluetoothService =
new BluetoothService(configs: [config]);
@override
void initState() {
super.initState();
this.startup();
}
void startup() async {
await setState(() {
messages.add("searing devices...");
});
await bluetoothService.shutdown();
bluetoothService.onServiceDeviceFound(onServiceDeviceFound);
await bluetoothService.startScan();
}
void onServiceDeviceFound(BluetoothServiceDevice device) async {
print("device ${device.device} ${device.name}");
await setState(() {
messages.add("startup devices with name TKB_BLE...${device.name}");
});
try {
await bluetoothService.stopScan();
await bluetoothService.startupDevice(device.deviceId);
await setState(() {
messages.add("writing data : 000062");
});
print("write data");
HexValue value = await device.write("000062");
print("write data success");
await setState(() {
messages.add("writing data success, response: ${value.string}");
});
print("=================" + value.string);
} on BleError catch (e) {
print(
">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> ${e.code} ${e.message}");
setState(() {
messages.add("Ble error : ${e.code} ${e.message}");
});
} catch (e) {
print(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> $e");
setState(() {
messages.add("other error : ${e.code} ${e.message}");
});
}
}
