Flutter蓝牙配置插件blufi_plugin的使用

Flutter蓝牙配置插件blufi_plugin的使用

简介

blufi_plugin 是一个用于Flutter应用程序的插件，旨在通过蓝牙与ESP设备进行通信和配置。该插件依赖于两个平台特定的库：

• iOS: EspBlufiForiOS
• Android: EspBlufiForAndroid

这些库提供了与ESP设备进行蓝牙通信的功能，允许开发者在Flutter应用中实现蓝牙扫描、连接和配置等功能。

快速上手

blufi_plugin 是一个Flutter插件包，包含针对Android和iOS平台的原生实现代码。要开始使用此插件，您需要确保已经安装并配置好了Flutter开发环境。如果您是第一次使用Flutter，建议先阅读官方文档，了解如何创建和配置Flutter项目。

示例代码

以下是一个完整的示例代码，展示了如何使用 blufi_plugin 插件来实现蓝牙设备的扫描、连接和配置功能。这个示例应用程序包括了扫描设备、停止扫描、连接设备、关闭连接以及发送自定义数据的功能。

import 'dart:convert';
import 'package:flutter/material.dart';
import 'package:blufi_plugin/blufi_plugin.dart';

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

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String contentJson = 'Unknown'; // 用于显示接收到的数据
  Map<String, dynamic> scanResult = {}; // 保存扫描到的设备信息

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

    // 监听蓝牙消息
    BlufiPlugin.instance.onMessageReceived(
      successCallback: (String data) {
        print("success data: $data");
        setState(() {
          contentJson = data;
          Map<String, dynamic> mapData = json.decode(data);
          if (mapData.containsKey('key')) {
            String key = mapData['key'];
            if (key == 'ble_scan_result') {
              // 处理扫描结果
              Map<String, dynamic> peripheral = mapData['value'];
              String address = peripheral['address'];
              String name = peripheral['name'];
              int rssi = peripheral['rssi'];
              print(rssi);
              scanResult[address] = name; // 将设备地址和名称存入scanResult
            }
          }
        });
      },
      errorCallback: (String error) {
        print("error: $error"); // 处理错误
      },
    );
  }

  // 初始化平台状态
  Future<void> initPlatformState() async {
    String platformVersion;
    try {
      platformVersion = await BlufiPlugin.instance.platformVersion;
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    if (!mounted) return;
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Column(
          children: [
            // 扫描设备按钮
            TextButton(
              onPressed: () async {
                await BlufiPlugin.instance.scanDeviceInfo(filterString: 'VCONNEX');
              }, 
              child: Text('Scan')
            ),
            // 停止扫描按钮
            TextButton(
              onPressed: () async {
                await BlufiPlugin.instance.stopScan();
              }, 
              child: Text('Stop Scan')
            ),
            // 连接设备按钮
            TextButton(
              onPressed: () async {
                if (scanResult.isNotEmpty) {
                  String firstAddress = scanResult.keys.first;
                  await BlufiPlugin.instance.connectPeripheral(peripheralAddress: firstAddress);
                } else {
                  print('No devices found to connect');
                }
              }, 
              child: Text('Connect Peripheral')
            ),
            // 关闭连接按钮
            TextButton(
              onPressed: () async {
                await BlufiPlugin.instance.requestCloseConnection();
              }, 
              child: Text('Close Connect')
            ),
            // 配置Wi-Fi按钮
            TextButton(
              onPressed: () async {
                await BlufiPlugin.instance.configProvision(username: 'ABCXYZ', password: '0913456789');
              }, 
              child: Text('Config Provision')
            ),
            // 发送自定义数据按钮
            TextButton(
              onPressed: () async {
                String command = '12345678';
                await BlufiPlugin.instance.postCustomData(command);
              }, 
              child: Text('Send Custom Data')
            ),
            // 显示接收到的数据
            Text(contentJson ?? '')
          ],
        ),
      ),
    );
  }
}