Flutter蓝牙读取插件ble_reader的使用

发布于 1周前 作者 itying888 来自 Flutter

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

1 回复

更多关于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细节可能会有所不同。

回到顶部