Flutter 开发之蓝牙通信

本文包含：

蓝牙简介；

Flutter 中蓝牙开发步骤；

Flutter 插件 flutter_blue 介绍；

Flutter 插件 flutter_blue 详细使用步骤；

Flutter 插件 flutter_blue 的二次封装，以便简洁调用；

Flutter 完整 蓝牙通讯 含：搜索，连接，匹配特征值，发送数据，接收数据 下载地址；

Flutter 完整 蓝牙通讯项目实例修改 下位机参数 特征值可直接使用 (暂无)；

蓝牙简介；

蓝牙是设备近距离通信的一种方便手段，现在很多蓝牙设备都是指蓝牙4.0，4.0以其低功耗著称。
通过蓝牙进行通讯交互分为两方，一方为中心设备central(手机)，一方为外设peripheral(下位机硬件设备)，外设通过广播的方式向外发送信息，中心设备检索到外设发的广播信息，可以进行配对连接，进而进行数据交互。

Flutter 中蓝牙开发步骤；

简单概括为：
1.添加蓝牙权限
2.扫描蓝牙设备
3.连接到设备并显示具有特征的服务
4.匹配对应权限特征。例如：有读取，写入权限的特征值
5.根据协议向下位机设备写入数据
6.手机端接收到下位机返回的数据，并相应处理

Flutter 插件 flutter_blue 介绍；

FlutterBlue是一款flutter对蓝牙插件,旨在提供来自两个平台（iOS和Android）的最大功能。 使用FlutterBlue实例，您可以扫描并连接到附近的设备（BluetoothDevice）。一旦连接到设备，BluetoothDevice对象就可以发现服务（BluetoothService），特征（BluetoothCharacteristic）和描述符（BluetoothDescriptor）。然后，BluetoothDevice对象用于直接与特征和描述符交互。

flutter_blue 官方介绍以及官方示例下载地址 小声逼逼：我觉得示例不咋地...

Flutter 插件 flutter_blue 详细使用步骤；

1.添加蓝牙权限

Android 端权限添加：

//文件名：AndroidManifest.xml
        
        

Android 端权限添加地址

iOS 端权限添加：

//文件名：Info.plist
    NSBluetoothAlwaysUsageDescription
    App需要您的同意,才能访问蓝牙,进行设备连接,数据通讯服务
    NSBluetoothPeripheralUsageDescription
    App需要您的同意,才能访问蓝牙,进行设备连接,数据通讯服务

iOS 端权限添加地址

2.添加flutter_blue库

//文件名：pubspec.yaml
    flutter_blue: ^0.7.2

3.创建实例 FlutterBlue

//在你需要连接操作蓝牙的xxxx.dart 界面中 导入
import 'package:flutter_blue/flutter_blue.dart';

//可能用到的异步操作库
import 'dart:async';

FlutterBlue flutterBlue = FlutterBlue.instance;

/*
提示
个人建议 实例创建 在 initState方法中 ，并且FlutterBlue flutterBlue 声明出来，因为后面操作要用到flutterBlue
*/

4.扫描蓝牙设备

// 开始扫描 
              flutterBlue.startScan();
              // 监听扫描结果
              flutterBlue.scanResults.listen((results) {
                // 扫描结果 可扫描到的所有蓝牙设备
                for (ScanResult r in results) {
                  scanResults[r.device.name] = r;
                  if (r.device.name.length > 0) {
                    print('${r.device.name} found! rssi: ${r.rssi}');
                    allBlueNameAry.add(r.device.name);
                  }
                }
              });
/*
备注

scanResults  是我在前面有声明的一个 所有搜索结果数据集
allBlueNameAry  是我在前面声明的一个 所有搜索到蓝牙名字的数组
mCharacteristic 是我在前面声明的一个特征 因为写入数据，接收数据回调时需要用到，所以我声明在前面 

Map scanResults = new Map();
List allBlueNameAry = [];
BluetoothCharacteristic mCharacteristic;

*/

5.连接到设备并显示具有特征的服务

List distinctIds = allBlueNameAry.toSet().toList();
              print("我是过滤后的 蓝牙名字 $distinctIds");
              for (var i = 0; i < distinctIds.length; i++) {
                bool isEquipment = distinctIds[i].contains("需要连接的设备名");
                if (isEquipment) {
                  ScanResult r = scanResults[distinctIds[i]];
                  device = r.device;
                  
                  // 停止扫描
                  flutterBlue.stopScan();
                  
                  // 连接蓝牙设备 以及扫描特征值
                  _BleDiscoverServices();
                }
              }

6.匹配对应权限特征。例如：有读取，写入权限的特征值

//_BleDiscoverServices 方法在5.连接到设备并显示具有特征的服务中调用
 _BleDiscoverServices() async {
    print("连接上GTRS设备...延迟连接");
    await device.connect(autoConnect: false, timeout: Duration(seconds: 10));
    List services = await device.discoverServices();
    services.forEach((service) {
      var value = service.uuid.toString();
      print("所有服务值 --- $value");
      if (service.uuid.toString().toUpperCase().substring(4, 8) == "FFF0") {
        List characteristics = service.characteristics;
        characteristics.forEach((characteristic) {
          var valuex = characteristic.uuid.toString();
          print("所有特征值 --- $valuex");
          if (characteristic.uuid.toString() ==
              "0000fff1-0000-1000-8000-XXXXXXXXXX") {
            print("匹配到正确的特征值");
            mCharacteristic = characteristic;

            const timeout = const Duration(seconds: 30);
            Timer(timeout, () {
              //收到下位机返回蓝牙数据回调监听
              _BleDataCallback();
            });
          }
        });
      }
    });
  }

7.根据协议向下位机设备写入数据

//mCharacteristic   4.扫描蓝牙设备备注有介绍、6.匹配对应权限特征中给它赋值
mCharacteristic.write(
                    [0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00]);

8.手机端接收到下位机返回的数据，并相应处理

//mCharacteristic   4.扫描蓝牙设备备注有介绍、6.匹配对应权限特征中给它赋值
//_BleDataCallback 方法在6.匹配对应权限特征中 调用
  _BleDataCallback() async {
    await mCharacteristic.setNotifyValue(true);
    mCharacteristic.value.listen((value) {
      // do something with new value
      // print("我是蓝牙返回数据 - $value");
      if (value == null) {
        print("我是蓝牙返回数据 - 空！！");
        return;
      }
      List data = [];
      for (var i = 0; i < value.length; i++) {
        String dataStr = value[i].toRadixString(16);
        if (dataStr.length < 2) {
          dataStr = "0" + dataStr;
        }
        String dataEndStr = "0x" + dataStr;
        data.add(dataEndStr);
      }
      print("我是蓝牙返回数据 - $data");
    });
  }

9.断开蓝牙连接

device.disconnect();

Flutter 插件 flutter_blue 的二次封装，以便简洁调用：

//创建 一个叫  -- ble_mannager.dart 文件
/*以下全部复制进文件*/
import 'dart:math';
import 'package:flutter_blue/flutter_blue.dart';
import 'dart:async';

class ble_data_model {
  /*
  蓝牙参数
  */
  FlutterBlue flutterBlue;
  BluetoothDevice device;
  Map scanResults;
  List allBleNameAry;
  BluetoothCharacteristic mCharacteristic;
}

//蓝牙数据模型
ble_data_model model = new ble_data_model();

void initBle() {
  BluetoothDevice device;
  Map scanResults = new Map();
  List allBleNameAry = [];
  BluetoothCharacteristic mCharacteristic;

  model.flutterBlue = FlutterBlue.instance;
  model.device = device;
  model.scanResults = scanResults;
  model.allBleNameAry = allBleNameAry;
  model.mCharacteristic = mCharacteristic;
}

void startBle() async {
  // 开始扫描
  model.flutterBlue.startScan(timeout: Duration(seconds: 4));
  // 监听扫描结果
  model.flutterBlue.scanResults.listen((results) {
    // 扫描结果 可扫描到的所有蓝牙设备
    for (ScanResult r in results) {
      model.scanResults[r.device.name] = r;
      if (r.device.name.length > 0) {
        // print('${r.device.name} found! rssi: ${r.rssi}');
        model.allBleNameAry.add(r.device.name);
        getBleScanNameAry();
      }
    }
  });
}

List getBleScanNameAry() {
  //更新过滤蓝牙名字
  List distinctIds = model.allBleNameAry.toSet().toList();
  model.allBleNameAry = distinctIds;
  return model.allBleNameAry;
}

void connectionBle(int chooseBle) {
  for (var i = 0; i < model.allBleNameAry.length; i++) {
    bool isBleName = model.allBleNameAry[i].contains("GTRS");
    if (isBleName) {
      ScanResult r = model.scanResults[model.allBleNameAry[i]];
      model.device = r.device;

      // 停止扫描
      model.flutterBlue.stopScan();

      discoverServicesBle();
    }
  }
}

void discoverServicesBle() async {
  print("连接上蓝牙设备...延迟连接");
  await model.device
      .connect(autoConnect: false, timeout: Duration(seconds: 10));
  List services = await model.device.discoverServices();
  services.forEach((service) {
    var value = service.uuid.toString();
    print("所有服务值 --- $value");
    if (service.uuid.toString().toUpperCase().substring(4, 8) == "FFF0") {
      List characteristics = service.characteristics;
      characteristics.forEach((characteristic) {
        var valuex = characteristic.uuid.toString();
        print("所有特征值 --- $valuex");
        if (characteristic.uuid.toString() ==
            "0000fff1-0000-1000-8000-xxxxxxxxx") {
          print("匹配到正确的特征值");
          model.mCharacteristic = characteristic;

          const timeout = const Duration(seconds: 30);
          Timer(timeout, () {
            dataCallbackBle();
          });
        }
      });
    }
    // do something with service
  });
}

dataCallsendBle(List value) {
  model.mCharacteristic.write(value);
}

dataCallbackBle() async {
  await model.mCharacteristic.setNotifyValue(true);
  model.mCharacteristic.value.listen((value) {
    // do something with new value
    // print("我是蓝牙返回数据 - $value");
    if (value == null) {
      print("我是蓝牙返回数据 - 空！！");
      return;
    }
    List data = [];
    for (var i = 0; i < value.length; i++) {
      String dataStr = value[i].toRadixString(16);
      if (dataStr.length < 2) {
        dataStr = "0" + dataStr;
      }
      String dataEndStr = "0x" + dataStr;
      data.add(dataEndStr);
    }
    print("我是蓝牙返回数据 - $data");
  });
}

void endBle() {
  model.device.disconnect();
}

Flutter 完整 蓝牙通讯 含：搜索，连接，匹配特征值，发送数据，接收数据；

自行封装 flutter_ble_mannager 暂缺实例

Flutter 完整 蓝牙通讯项目实例修改 下位机参数 特征值可直接使用；

//未完待续