Flutter蓝牙通信插件vorld

vorld_ble

vorld_ble 是一个用于发现BLE Vorld设备的Flutter插件。

获取开始

这个项目是一个自定义的Flutter插件，属于插件包的一种，它包含针对Android和/或iOS的平台特定实现代码。

对于如何开始Flutter开发的帮助，请查看在线文档，其中提供了教程、示例、移动开发指南以及完整的API参考。

使用示例

以下是一个完整的示例代码，展示如何使用 vorld_ble 插件来发现BLE设备并实时更新设备名称。

示例代码

// 导入必要的库
import 'package:flutter/material.dart';
import 'package:vorld_ble/vorld_ble.dart'; // 引入vorld_ble插件

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> {
  String _deviceName = 'Unknown'; // 保存发现的设备名称

  [@override](/user/override)
  void initState() {
    super.initState();

    // 监听设备更新事件
    VorldBle.deviceUpdates!.listen((update) {
      _deviceName = update.deviceName ?? 'Unknown'; // 更新设备名称
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('vorld_ble 示例'), // 应用标题
        ),
        body: Center(
          child: Text('发现的设备: $_deviceName\n'), // 显示设备名称
        ),
      ),
    );
  }
}

zlyuanteng 1楼•9 天前

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

vorld_ble 是一个用于 Flutter 的蓝牙低功耗（BLE）通信插件。它允许开发者在 Flutter 应用中轻松地与 BLE 设备进行通信。以下是如何使用 vorld_ble 插件的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 vorld_ble 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  vorld_ble: ^0.0.1  # 请使用最新版本

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

2. 导入插件

在你的 Dart 文件中导入 vorld_ble 插件：

import 'package:vorld_ble/vorld_ble.dart';

3. 初始化蓝牙

在使用蓝牙功能之前，你需要初始化蓝牙适配器：

VorldBle vorldBle = VorldBle();

void initBluetooth() async {
  bool isInitialized = await vorldBle.initialize();
  if (isInitialized) {
    print("Bluetooth initialized successfully");
  } else {
    print("Failed to initialize Bluetooth");
  }
}

4. 扫描设备

你可以使用 startScan 方法来扫描附近的 BLE 设备：

void startScanning() {
  vorldBle.startScan().listen((device) {
    print("Found device: ${device.name}, ${device.id}");
  }, onError: (error) {
    print("Error while scanning: $error");
  });
}

5. 停止扫描

当你不再需要扫描设备时，可以调用 stopScan 方法来停止扫描：

void stopScanning() {
  vorldBle.stopScan();
  print("Scanning stopped");
}

6. 连接设备

要连接到一个 BLE 设备，你可以使用 connect 方法：

void connectToDevice(String deviceId) async {
  bool isConnected = await vorldBle.connect(deviceId);
  if (isConnected) {
    print("Connected to device: $deviceId");
  } else {
    print("Failed to connect to device: $deviceId");
  }
}

7. 断开连接

当你不再需要与设备通信时，可以断开连接：

void disconnectFromDevice(String deviceId) async {
  await vorldBle.disconnect(deviceId);
  print("Disconnected from device: $deviceId");
}

8. 读取和写入特征值

你可以使用 readCharacteristic 和 writeCharacteristic 方法来读取和写入 BLE 设备的特征值：

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

void writeCharacteristic(String deviceId, String serviceUuid, String characteristicUuid, List<int> value) async {
  await vorldBle.writeCharacteristic(deviceId, serviceUuid, characteristicUuid, value);
  print("Value written successfully");
}

9. 监听特征值变化

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

void listenToCharacteristic(String deviceId, String serviceUuid, String characteristicUuid) {
  vorldBle.setNotification(deviceId, serviceUuid, characteristicUuid).listen((value) {
    print("Characteristic value changed: $value");
  }, onError: (error) {
    print("Error while listening to characteristic: $error");
  });
}

10. 处理权限

在 Android 上，使用蓝牙功能需要一些权限。你需要在 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>We need access to Bluetooth to connect to your device.</string>
<key>NSBluetoothPeripheralUsageDescription</key>
<string>We need access to Bluetooth to connect to your device.</string>

11. 处理错误

在使用 vorld_ble 插件时，可能会遇到各种错误。你可以通过捕获异常来处理这些错误：

try {
  await vorldBle.connect(deviceId);
} catch (e) {
  print("Error connecting to device: $e");
}

12. 释放资源

当你不再需要使用蓝牙功能时，可以释放资源：

void dispose() {
  vorldBle.dispose();
  print("Bluetooth resources released");
}