Flutter蓝牙管理插件another_ble_manager的使用

Flutter蓝牙管理插件Another BLE Manager的使用

在Flutter中,如果你需要进行蓝牙设备的连接、配置和交互操作,可以使用another_ble_manager插件。该插件提供了基础的蓝牙状态管理框架,但并不直接处理原生的蓝牙连接功能,而是作为现有原生库之上的控制层。

安装插件

首先,在你的pubspec.yaml文件中添加another_ble_manager依赖:

dependencies:
  flutter:
    sdk: flutter
  another_ble_manager: ^0.2.1

然后运行flutter pub get来安装该依赖。

初始化插件

在你的应用启动时初始化插件。通常在main.dart中进行初始化:

import 'package:flutter/material.dart';
import 'package:another_ble_manager/another_ble_manager.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: BluetoothPage(),
    );
  }
}

检查蓝牙权限

确保你的应用具有访问蓝牙的权限。在AndroidManifest.xml中添加以下权限:

<uses-permission android:name="android.permission.BLUETOOTH"/>
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

在iOS的Info.plist中添加以下权限:

<key>NSBluetoothAlwaysUsageDescription</key>
<string>我们需要您的蓝牙权限</string>
<key>NSBluetoothPeripheralUsageDescription</key>
<string>我们需要您的蓝牙权限</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>我们需要您的位置权限</string>

扫描蓝牙设备

使用another_ble_manager插件扫描周围的蓝牙设备:

import 'package:flutter/material.dart';
import 'package:another_ble_manager/another_ble_manager.dart';

class BluetoothPage extends StatefulWidget {
  @override
  _BluetoothPageState createState() => _BluetoothPageState();
}

class _BluetoothPageState extends State<BluetoothPage> {
  final bleManager = BleManager();

  @override
  void initState() {
    super.initState();
    // 开始扫描蓝牙设备
    startScan();
  }

  void startScan() async {
    await bleManager.startScan(timeout: Duration(seconds: 4));
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('蓝牙设备列表'),
      ),
      body: StreamBuilder<List<BleDevice>>(
        stream: bleManager.scanStream,
        initialData: [],
        builder: (context, snapshot) {
          if (!snapshot.hasData || snapshot.data!.isEmpty) {
            return Center(child: Text('未找到设备'));
          }
          return ListView.builder(
            itemCount: snapshot.data!.length,
            itemBuilder: (context, index) {
              final device = snapshot.data![index];
              return ListTile(
                title: Text(device.name ?? '未知设备'),
                subtitle: Text(device.id),
                onTap: () {
                  // 连接设备
                  connectToDevice(device);
                },
              );
            },
          );
        },
      ),
    );
  }

  void connectToDevice(BleDevice device) async {
    await bleManager.connect(device);
    // 设备连接成功后可以进行进一步操作,例如读写数据
  }
}

连接和通信

当你选择一个设备并点击它时,调用connectToDevice方法进行连接。连接成功后,你可以通过该设备对象进行读写操作。

断开连接

当你完成与设备的通信时,可以通过调用disconnect方法断开连接:

await bleManager.disconnect(device);

更多关于Flutter蓝牙管理插件another_ble_manager的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter蓝牙管理插件another_ble_manager的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


another_ble_manager 是一个用于 Flutter 的蓝牙管理插件,它提供了对蓝牙设备的扫描、连接、读写等操作的支持。以下是如何使用 another_ble_manager 插件的基本步骤:

1. 添加依赖

首先,在 pubspec.yaml 文件中添加 another_ble_manager 插件的依赖:

dependencies:
  flutter:
    sdk: flutter
  another_ble_manager: ^0.0.1  # 请检查最新版本

然后运行 flutter pub get 来获取依赖。

2. 导入插件

在你的 Dart 文件中导入 another_ble_manager

import 'package:another_ble_manager/another_ble_manager.dart';

3. 初始化蓝牙管理器

在使用蓝牙功能之前,需要初始化蓝牙管理器:

final bleManager = AnotherBleManager();

void initBle() async {
  await bleManager.initialize();
}

4. 扫描蓝牙设备

你可以使用 startScan 方法来扫描附近的蓝牙设备:

void scanDevices() async {
  bleManager.startScan(
    onDeviceFound: (device) {
      print('Found device: ${device.name}, ${device.id}');
    },
  );
}

5. 停止扫描

当你不再需要扫描设备时,可以调用 stopScan 方法:

void stopScanning() {
  bleManager.stopScan();
}

6. 连接设备

要连接一个蓝牙设备,可以使用 connect 方法:

void connectToDevice(String deviceId) async {
  await bleManager.connect(deviceId);
  print('Connected to device: $deviceId');
}

7. 断开连接

当你不再需要连接时,可以调用 disconnect 方法:

void disconnectDevice(String deviceId) async {
  await bleManager.disconnect(deviceId);
  print('Disconnected from device: $deviceId');
}

8. 读取特征值

你可以使用 readCharacteristic 方法来读取蓝牙设备的特征值:

void readCharacteristic(String deviceId, String serviceUuid, String characteristicUuid) async {
  List<int> value = await bleManager.readCharacteristic(deviceId, serviceUuid, characteristicUuid);
  print('Read value: $value');
}

9. 写入特征值

你可以使用 writeCharacteristic 方法来向蓝牙设备写入数据:

void writeCharacteristic(String deviceId, String serviceUuid, String characteristicUuid, List<int> value) async {
  await bleManager.writeCharacteristic(deviceId, serviceUuid, characteristicUuid, value);
  print('Write value: $value');
}

10. 监听特征值变化

你可以使用 setNotification 方法来监听特征值的变化:

void listenToCharacteristic(String deviceId, String serviceUuid, String characteristicUuid) {
  bleManager.setNotification(
    deviceId,
    serviceUuid,
    characteristicUuid,
    onValueChanged: (value) {
      print('Characteristic value changed: $value');
    },
  );
}

11. 处理权限

在使用蓝牙功能时,确保你已经获取了必要的权限。你可以在 AndroidManifest.xmlInfo.plist 中添加相应的权限声明。

12. 处理错误

在使用蓝牙功能时,可能会遇到各种错误,例如设备无法连接、特征值无法读取等。你可以在调用方法时使用 try-catch 块来捕获和处理这些错误。

void connectToDevice(String deviceId) async {
  try {
    await bleManager.connect(deviceId);
    print('Connected to device: $deviceId');
  } catch (e) {
    print('Failed to connect: $e');
  }
}

13. 释放资源

当你不再需要使用蓝牙管理器时,可以调用 dispose 方法来释放资源:

void disposeBleManager() {
  bleManager.dispose();
}
回到顶部