Flutter蓝牙通信插件universal_ble的使用
Flutter蓝牙通信插件universal_ble的使用
一、简介
universal_ble
是一个跨平台(Android/iOS/macOS/Windows/Linux/Web)的Bluetooth Low Energy (BLE) 插件,适用于Flutter应用。它提供了丰富的功能来满足不同的开发需求。
你可以通过 在线体验 来感受这个插件的强大之处(需浏览器支持Web Bluetooth)。
二、特性
- 扫描设备:可以启动和停止扫描,并且可以通过过滤器精确找到目标设备。
- 连接管理:能够建立与断开蓝牙设备的连接。
- 服务发现:获取已连接设备的服务列表。
- 数据读写:对指定特征进行数据的读取或写入操作。
- 配对处理:实现设备间的配对及取消配对。
- 蓝牙状态检测:检查当前蓝牙是否可用以及监听其状态变化。
- 命令队列控制:支持全局队列、每设备独立队列或者完全并行执行。
- 超时设置:为所有命令设定默认超时时间。
- UUID格式无关性:无论输入何种格式的UUID,都能正确解析。
三、使用方法
1. 添加依赖
在 pubspec.yaml
文件中添加如下内容:
dependencies:
universal_ble: ^latest_version # 替换为最新版本号
然后在需要使用的Dart文件顶部导入库:
import 'package:universal_ble/universal_ble.dart';
2. 基础用法示例
(1)初始化并开始扫描
确保蓝牙处于开启状态后开始扫描附近设备:
// 检查蓝牙是否已开启
if (await UniversalBle.getBluetoothAvailabilityState() == AvailabilityState.poweredOn) {
// 设置扫描结果回调函数
UniversalBle.onScanResult = (bleDevice) {
print('Found device: ${bleDevice.name}');
};
// 开始扫描
UniversalBle.startScan();
}
(2)连接设备
当接收到感兴趣的设备时,可以通过其ID建立连接:
String deviceId = bleDevice.deviceId;
UniversalBle.connect(deviceId);
(3)发现服务
连接成功后,下一步就是查找该设备提供的所有服务:
await UniversalBle.discoverServices(deviceId);
(4)读写特征值
针对某个具体的服务及其特征,我们可以执行相应的读写操作:
// 写入数据到特征
await UniversalBle.writeValue(deviceId, serviceId, characteristicId, Uint8List.fromList([0x01]));
// 订阅通知
await UniversalBle.setNotifiable(deviceId, serviceId, characteristicId, BleInputProperty.notification);
// 接收来自特征的通知消息
UniversalBle.onValueChange = (deviceId, characteristicId, value) {
print('Received data from $characteristicId: ${hex.encode(value)}');
};
(5)配对
对于某些场景下可能需要先完成配对才能进一步交互:
bool? isPaired = await UniversalBle.pair(deviceId);
print('Pairing result: $isPaired');
(6)处理蓝牙状态变化
为了更好地用户体验,建议监听蓝牙状态的变化:
UniversalBle.onAvailabilityChange = (state) {
if (state == AvailabilityState.poweredOn) {
print('Bluetooth has been turned on.');
} else {
print('Bluetooth is not available.');
}
};
3. 完整示例代码
下面是一个完整的Demo程序,展示了如何结合上述步骤创建一个简单的Flutter应用程序来搜索附近的BLE设备并显示它们的信息。
import 'package:flutter/material.dart';
import 'package:universal_ble/universal_ble.dart';
void main() => runApp(MyApp());
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
title: 'Universal BLE Demo',
theme: ThemeData(
primarySwatch: Colors.blue,
),
home: DeviceScanner(),
);
}
}
class DeviceScanner extends StatefulWidget {
@override
_DeviceScannerState createState() => _DeviceScannerState();
}
class _DeviceScannerState extends State<DeviceScanner> {
final List<BleDevice> _devices = [];
@override
void initState() {
super.initState();
// 监听扫描结果
UniversalBle.onScanResult = (device) {
setState(() {
_devices.add(device);
});
};
// 检查蓝牙是否可用
checkBluetoothAvailability();
}
Future<void> checkBluetoothAvailability() async {
AvailabilityState state = await UniversalBle.getBluetoothAvailabilityState();
if (state == AvailabilityState.poweredOn) {
startScanning();
} else {
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(content: Text('Please turn on Bluetooth and try again.')),
);
}
}
void startScanning() {
UniversalBle.startScan();
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text('Nearby Devices'),
),
body: ListView.builder(
itemCount: _devices.length,
itemBuilder: (context, index) {
final device = _devices[index];
return ListTile(
title: Text(device.name ?? 'Unknown Device'),
subtitle: Text(device.address),
);
},
),
);
}
@override
void dispose() {
UniversalBle.stopScan();
super.dispose();
}
}
此段代码创建了一个名为 MyApp
的Flutter应用程序,其中包含一个名为 DeviceScanner
的页面。该页面会尝试启动蓝牙扫描,并将发现的设备名称和地址展示在一个列表视图中。同时,在页面销毁时会停止正在进行的扫描任务。
希望这份指南对你有所帮助!如果你还有其他问题,请随时提问。
更多关于Flutter蓝牙通信插件universal_ble的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html
更多关于Flutter蓝牙通信插件universal_ble的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html
当然,以下是一个使用 universal_ble
插件进行蓝牙通信的 Flutter 代码示例。这个示例展示了如何扫描蓝牙设备、连接到设备以及读写数据。
首先,确保你在 pubspec.yaml
文件中添加了 universal_ble
依赖:
dependencies:
flutter:
sdk: flutter
universal_ble: ^x.y.z # 请替换为最新版本号
然后运行 flutter pub get
来安装依赖。
接下来是 Flutter 代码示例:
import 'package:flutter/material.dart';
import 'package:universal_ble/universal_ble.dart';
void main() {
runApp(MyApp());
}
class MyApp extends StatefulWidget {
@override
_MyAppState createState() => _MyAppState();
}
class _MyAppState extends State<MyApp> {
UniversalBleManager? bleManager;
List<DiscoveredDevice> discoveredDevices = [];
ConnectedDevice? connectedDevice;
@override
void initState() {
super.initState();
bleManager = UniversalBleManager.builder()
.setLogLevel(BleLogLevel.verbose)
.build();
bleManager?.scanForDevices(
allowDuplicatesKey: true,
scanMode: ScanMode.lowLatency,
matchNum: 1,
scanCallback: (result) {
setState(() {
discoveredDevices = result;
});
},
errorCallback: (error) {
print("Scan error: $error");
},
);
}
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
appBar: AppBar(
title: Text('Flutter Bluetooth Communication'),
),
body: Padding(
padding: const EdgeInsets.all(16.0),
child: Column(
children: [
Text('Discovered Devices:'),
Expanded(
child: ListView.builder(
itemCount: discoveredDevices.length,
itemBuilder: (context, index) {
var device = discoveredDevices[index];
return ListTile(
title: Text(device.name ?? 'Unknown Device'),
trailing: IconButton(
icon: Icon(Icons.connect_without_contact),
onPressed: () {
connectToDevice(device);
},
),
);
},
),
),
if (connectedDevice != null)
Column(
children: [
Text('Connected Device: ${connectedDevice?.name ?? 'Unknown'}'),
ElevatedButton(
onPressed: () {
writeDataToDevice();
},
child: Text('Write Data'),
),
],
),
],
),
),
),
);
}
void connectToDevice(DiscoveredDevice device) {
bleManager?.connectToDevice(
deviceId: device.id,
connectionTimeout: 5000,
connectionCallback: (result) {
setState(() {
connectedDevice = result;
});
},
disconnectCallback: (device) {
setState(() {
connectedDevice = null;
});
},
errorCallback: (error) {
print("Connection error: $error");
},
);
}
void writeDataToDevice() {
if (connectedDevice != null) {
var serviceUuid = 'your-service-uuid'; // 替换为你的服务 UUID
var characteristicUuid = 'your-characteristic-uuid'; // 替换为你的特征 UUID
bleManager?.writeCharacteristicForDevice(
deviceId: connectedDevice!.id,
serviceUuid: serviceUuid,
characteristicUuid: characteristicUuid,
data: Uint8List.fromList([0x01, 0x02, 0x03]), // 示例数据
writeType: CharacteristicWriteType.withResponse,
writeCallback: (result) {
print("Write success: $result");
},
errorCallback: (error) {
print("Write error: $error");
},
);
}
}
@override
void dispose() {
bleManager?.destroy();
super.dispose();
}
}
注意事项:
- UUID:确保你使用正确的服务 UUID 和特征 UUID。这些 UUID 通常是蓝牙设备文档或规范中提供的。
- 权限:确保在
AndroidManifest.xml
和Info.plist
中添加了蓝牙相关的权限。 - 错误处理:在实际应用中,添加更多的错误处理和用户反馈以提高用户体验。
这个示例展示了如何使用 universal_ble
插件进行蓝牙设备扫描、连接和通信。根据你的具体需求,你可能需要调整代码中的 UUID、数据格式和处理逻辑。