Flutter蓝牙读取插件ble_reader的使用
Flutter蓝牙读取插件ble_reader的使用
本项目是一个Flutter插件,通过在pubspec.yaml
文件中添加依赖来使用它。
安装
在pubspec.yaml
文件中添加以下依赖:
dependencies:
flutter:
sdk: flutter
ble_reader: ^0.1.0
然后运行以下命令以获取依赖项:
$ flutter pub get
如何使用
请检查示例应用以了解如何广播接收的数据。
开始使用
Android
你需要在AndroidManifest.xml
文件中添加以下权限:
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" android:maxSdkVersion="30" />
如果你使用BLUETOOTH_SCAN
来确定位置,修改你的AndroidManifest.xml
文件以包含以下条目:
<uses-permission android:name="android.permission.BLUETOOTH_SCAN"
tools:remove="android:usesPermissionFlags"
tools:targetApi="s" />
如果你在应用程序中使用位置服务,请删除位置权限标签中的android:maxSdkVersion="30"
。
Android ProGuard规则
如果你正在使用ProGuard,请将以下片段添加到你的proguard-rules.pro
文件中:
-keep class com.signify.hue.** { *; }
这将防止出现如#131类似的问题。
iOS
对于iOS,你必须在应用程序的Info.plist
文件中添加以下条目。不允许访问Core Bluetooth而没有这些条目。参见我们的示例应用以了解如何实现这一点。更多详细信息请参阅关于iOS蓝牙权限的博客文章。
iOS13及以上版本
NSBluetoothAlwaysUsageDescription
iOS12及更低版本
NSBluetoothPeripheralUsageDescription
使用
导入
在需要使用的模块中导入插件:
import 'package:ble_reader/ble_reader.dart';
初始化
初始化库应该按以下方式执行:
final bleReader = BleReader();
设置连接并配置GATT服务器
final result = await BleReader.setupConnection;
if (!result) throw Exception('error bitches!!');
// 进行其他操作
接收数据流
StreamBuilder(
stream: BleReader.receivedDataStream,
initialData: 'None',
builder: (BuildContext context, AsyncSnapshot<dynamic> snapshot) {
return Text('Data received: ${snapshot.data}');
},
);
示例代码
以下是完整的示例代码:
import 'package:ble_reader/ble_reader.dart';
import 'package:flutter/material.dart';
void main() {
runApp(const MyApp());
}
class MyApp extends StatefulWidget {
const MyApp({super.key});
[@override](/user/override)
State<MyApp> createState() => _MyAppState();
}
class _MyAppState extends State<MyApp> {
[@override](/user/override)
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
appBar: AppBar(
title: const Text('插件示例应用'),
),
body: Center(
child: Column(
children: [
TextButton(
onPressed: () async {
final result = await BleReader.setupConnection;
print('示例应用日志: setupConnection 结果 = $result');
},
child: Text('setupConnection'),
),
TextButton(
onPressed: () {},
child: Text('testService'),
),
StreamBuilder(
stream: BleReader.receivedDataStream,
initialData: 'None',
builder: (BuildContext context, AsyncSnapshot<dynamic> snapshot) {
return Text('接收到的数据: ${snapshot.data}');
},
),
],
),
),
),
);
}
}
更多关于Flutter蓝牙读取插件ble_reader的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html
更多关于Flutter蓝牙读取插件ble_reader的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html
当然,下面是一个关于如何在Flutter应用中使用ble_reader
插件来读取蓝牙数据的示例代码。ble_reader
是一个假设的插件名称,用于演示目的,因为实际的Flutter蓝牙插件可能有不同的名称和功能集。不过,大多数蓝牙插件的基本用法是类似的。这里我们以flutter_blue
插件为例,因为它是一个流行的Flutter蓝牙插件。
首先,确保你已经在pubspec.yaml
文件中添加了flutter_blue
依赖:
dependencies:
flutter:
sdk: flutter
flutter_blue: ^x.y.z # 替换为最新版本号
然后,运行flutter pub get
来安装依赖。
接下来,我们编写一个基本的Flutter应用,该应用将扫描附近的蓝牙设备,连接到选定的设备,并读取其服务、特性和值。
import 'package:flutter/material.dart';
import 'package:flutter_blue/flutter_blue.dart';
void main() {
runApp(MyApp());
}
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
title: 'Flutter Bluetooth Reader',
theme: ThemeData(
primarySwatch: Colors.blue,
),
home: MyHomePage(),
);
}
}
class MyHomePage extends StatefulWidget {
@override
_MyHomePageState createState() => _MyHomePageState();
}
class _MyHomePageState extends State<MyHomePage> {
FlutterBlue flutterBlue = FlutterBlue.instance;
bool isScanning = false;
List<BluetoothDevice> devices = [];
BluetoothDevice selectedDevice;
List<BluetoothService> services = [];
BluetoothCharacteristic characteristic;
@override
void initState() {
super.initState();
flutterBlue.state.listen((state) {
if (state == BluetoothState.on) {
setState(() {});
}
});
}
Future<void> scanDevices() async {
setState(() {
isScanning = true;
devices.clear();
});
flutterBlue.scan().listen((scanResult) {
setState(() {
devices.add(scanResult.device);
});
}, onDone: () {
setState(() {
isScanning = false;
});
});
}
Future<void> connectToDevice(BluetoothDevice device) async {
setState(() {
selectedDevice = device;
});
await device.connect();
await device.discoverServices();
setState(() {
services = device.services;
});
}
Future<void> readCharacteristic(BluetoothCharacteristic characteristic) async {
setState(() {
this.characteristic = characteristic;
});
await characteristic.setNotifyValue(true);
characteristic.value.listen((value) {
// 处理读取到的数据
print('Characteristic value: ${value.toList()}');
});
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text('Flutter Bluetooth Reader'),
),
body: Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: <Widget>[
if (flutterBlue.state == BluetoothState.on)
ElevatedButton(
onPressed: isScanning ? null : scanDevices,
child: Text('Scan Devices'),
),
if (isScanning) CircularProgressIndicator(),
Expanded(
child: ListView.builder(
itemCount: devices.length,
itemBuilder: (context, index) {
final device = devices[index];
return ListTile(
title: Text('${device.name} (${device.id})'),
onTap: () => connectToDevice(device),
);
},
),
),
if (selectedDevice != null)
Column(
children: <Widget>[
Text('Selected Device: ${selectedDevice!.name}'),
ElevatedButton(
onPressed: () {
if (services.isNotEmpty) {
// 这里应该有一个界面来选择服务,为了简单起见,我们直接读取第一个服务中的第一个特性
final service = services.first;
service.characteristics.forEach((characteristic) {
readCharacteristic(characteristic);
});
}
},
child: Text('Read Characteristic'),
),
],
),
],
),
),
);
}
}
请注意,上述代码只是一个简化的示例,用于演示如何使用Flutter蓝牙插件进行设备扫描、连接、服务发现和特性读取。在实际应用中,你可能需要添加更多的错误处理、UI优化和特性值解析逻辑。
此外,由于ble_reader
是一个假设的插件名称,因此你可能需要查阅你实际使用的蓝牙插件的文档,以了解其具体用法和API。大多数蓝牙插件都会提供类似的功能,但API细节可能会有所不同。