Flutter蓝牙设备配置插件stratosfy_esp_ble

Flutter蓝牙设备配置插件stratosfy_esp_ble_provisioning的使用

获取开始

安装

在 pubspec.yaml 文件中添加以下依赖项：

dependencies:
  stratosfy_esp_ble_provisioning:

Android配置

确保你已经启用了flutter_embedding v2。在 AndroidManifest.xml 文件内 <application> 标签中添加以下代码以启用嵌入式支持：

<meta-data
    android:name="flutterEmbedding"
    android:value="2" />

同时，将你的 FlutterActivity 替换为 io.flutter.embedding.android.FlutterActivity。

蓝牙权限

请求蓝牙权限：

EspBleProvisioning().requestPermission();

蓝牙适配器状态

监听蓝牙适配器的状态变化：

EspBleProvisioning().getBluetoothStateStream().listen((state) {
  print("State *********** $state");
});

扫描蓝牙设备

启动扫描以查找蓝牙设备：

EspBleProvisioning().scanBluetoothDevice().listen((value) {
  setState(() {
    if (value.length > 0) {
      print("************DEVICE SCAN RESULT : $value");
      isScanned = true;
      isLoading = false;
      List names = [];
      devices.clear();
      for (int i = 0; i < value.length; i++) {
        if (!names.contains(value[i].name)) {
          devices.add(BleDevices(value[i].name, value[i].id));
        }
        names.add(value[i].name);
      }
    } else {
      isScanned = false;
      isLoading = false;
      showSnackBar("No devices found!");
    }
  });
});

连接到蓝牙设备

连接到已找到的蓝牙设备：

controller = EspBleProvisioning()
    .connectToBluetoothDevice(devices[index].name, pin)
    .listen((value) async {
  setState(() {
    if (value == "success") {
      print(value);
      isLoading = false;
      devices.clear();
      print("************security check completed");
    } else {
      isScanned = true;
      isLoading = false;
    }
  });

  _wifiDialog();
});

配置设备

通过输入WiFi凭证来配置设备：

provisionDevice(ssid, password).then((value) async {
  print("FrontEnd : $value");
  setState(() {
    isLoading = false;
    isScanned = false;
    devices.clear();
    print("Provision Status ----------> $value");
    // showSnackBar(value);
  });
  messageDialog(_getStatusFromKey(value), context);
  return true;
});

示例代码

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:stratosfy_esp_ble_provisioning/esp_bluetooth_provisioning.dart';
import 'package:stratosfy_esp_ble_provisioning/models/enums.dart';
import 'package:flutter_spinkit/flutter_spinkit.dart';
import 'POPDialog.dart';

void main() {
  runApp(MaterialApp(home: MyApp()));
}

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

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown';
  ScaffoldFeatureController<SnackBar, SnackBarClosedReason>? snackbar;

  BluetoothState? state;
  bool isScanned = false;
  bool isLoading = false;
  bool securityCheck = false;
  List<BleDevices> devices = [];
  String? loading;
  String? pin, ssid, password;
  StreamSubscription? controller;
  bool bleEnabled = true;

  bool? obscureText;

  [@override](/user/override)
  void initState() {
    super.initState();
    devices = [];
    loading = "";
    pin = "";
    ssid = "";
    password = "";
    obscureText = true;
    EspBleProvisioning().requestPermission();
    startListening();
    initPlatformState();
  }

  Future<void> initPlatformState() async {
    String platformVersion;
    try {
      platformVersion = await EspBleProvisioning.platformVersion;
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
      print("Platform version : $_platformVersion");
    });
  }

  Future startListening() async {
    print("** Listening **");
    EspBleProvisioning().getBluetoothStateStream().listen((state) async {
      print("State *********** $state");
      if (this.mounted)
        setState(() {
          this.state = state;
        });
      if (state == BluetoothState.ON) {
        if (snackbar != null) {
          snackbar!.close();
        }
        setState(() {
          bleEnabled = true;
        });
        print("Bluetooth ON");
      } else if (state == BluetoothState.OFF) {
        setState(() {
          bleEnabled = false;
        });
        showSnackBar("Please turn on bluetooth.");
      }
    });
  }

  scanBleDevice() {
    setState(() {
      isLoading = true;
      loading = "Scanning bluetooth devices";
    });
    controller =
        EspBleProvisioning().scanBluetoothDevice().listen((value) async {
      setState(() {
        if (value.length > 0) {
          print("************DEVICE SCAN RESULT : $value");
          isScanned = true;
          isLoading = false;
          List names = [];
          devices.clear();
          for (int i = 0; i < value.length; i++) {
            if (!names.contains(value[i].name)) {
              devices.add(BleDevices(value[i].name, value[i].id));
            }
            names.add(value[i].name);
          }
        } else {
          isScanned = false;
          isLoading = false;
          showSnackBar("No devices found!");
        }
      });
    });
  }

  connectBleDevice(String pin, int index) {
    setState(() {
      print("Connect to Device**************** ${devices[index].name}");
      loading = "Connecting to device";
      isLoading = true;
    });

    controller = EspBleProvisioning()
        .connectToBluetoothDevice(devices[index].name, pin)
        .listen((value) async {
      setState(() {
        if (value == "success") {
          print(value);
          isLoading = false;
          devices.clear();
          print("************security check completed");
        } else {
          isScanned = true;
          isLoading = false;
        }
      });

      _wifiDialog();
    });

    return true;
  }

  provisionDevice(String ssid, String password) async {
    setState(() {
      isLoading = true;
      loading = "Provisioning device";
      // todo testing only
      // ssid = "BM_Technovations_24";
      // password = (password == "") ?  "M@n1vannan" : password;
    });
    print("START WIFI PROVISIONING --- $ssid $password");
    EspBleProvisioning().startProvisioning(ssid, password).then((value) async {
      print("FrontEnd : $value");
      setState(() {
        isLoading = false;
        isScanned = false;
        devices.clear();
        print("Provision Status ----------> $value");
        // showSnackBar(value);
      });
      messageDialog(_getStatusFromKey(value), context);
      return true;
    });
  }

  void showSnackBar(message) {
    print("snackbar --> $message");
    ScaffoldMessenger.of(context).showSnackBar(SnackBar(
      content: Text(
        message,
        style: TextStyle(
          color: Colors.white,
        ),
      ),
      backgroundColor: Colors.black,
      action: SnackBarAction(
        label: 'Dismiss',
        textColor: Colors.red,
        disabledTextColor: Colors.white,
        onPressed: () {
          ScaffoldMessenger.of(context).hideCurrentSnackBar();
        },
      ),
    ));
  }

  void _showPOPDialog(BuildContext _context, int index) {
    showDialog(
        context: _context,
        builder: (BuildContext context) {
          return POPDialog(
            pin: "",
            onSubmit: (pin) {
              print('pin = $pin');
              connectBleDevice(pin, index);
            },
          );
        });
  }

  void _wifiDialog() {
    showDialog(
        context: context,
        builder: (BuildContext context) {
          return StatefulBuilder(builder: (BuildContext context, setState) {
            return AlertDialog(
              elevation: 5,
              backgroundColor: Colors.white,
              shape: RoundedRectangleBorder(
                  borderRadius: BorderRadius.circular(10.0)),
              content: Container(
                height: 320,
                color: Colors.transparent,
                child: Padding(
                  padding: const EdgeInsets.all(20.0),
                  child: Column(
                    mainAxisAlignment: MainAxisAlignment.center,
                    crossAxisAlignment: CrossAxisAlignment.center,
                    children: [
                      Text('Enter WiFi Credentials',
                          style: Theme.of(context).textTheme.bodyText2),
                      SizedBox(
                        height: 10.0,
                      ),
                      Padding(
                        padding: EdgeInsets.only(top: 8.0, left: 8, right: 8),
                        child: Container(
                          height: 60,
                          margin: EdgeInsets.all(8),
                          child: TextField(
                            decoration: InputDecoration(
                              border: OutlineInputBorder(),
                              labelText: 'ssid*',
                              hintText: 'ssid*',
                            ),
                            onChanged: (value) {
                              ssid = value;
                            },
                          ),
                        ),
                      ),
                      Container(
                        height: 60,
                        margin: EdgeInsets.only(top: 8.0, left: 16, right: 16),
                        child: TextField(
                          decoration: InputDecoration(
                            border: OutlineInputBorder(),
                            labelText: 'Password*',
                            hintText: 'Password*',
                            suffixIcon: IconButton(
                              onPressed: () {
                                setState(() {
                                  obscureText = !obscureText!;
                                });
                              },
                              icon: Icon(!obscureText!
                                  ? Icons.visibility
                                  : Icons.visibility_off),
                            ),
                          ),
                          obscureText: obscureText!,
                          onChanged: (value) {
                            password = value;
                          },
                        ),
                      ),
                      SizedBox(
                        height: 10.0,
                      ),
                      SizedBox(
                        width: double.infinity,
                        height: 50.0,
                        child: MaterialButton(
                            child: Text('Provision'),
                            color: Colors.redAccent,
                            onPressed: () {
                              print('onPressed ---');
                              print('ssid =$ssid, password = $password');
                              provisionDevice(ssid!, password!);
                              Navigator.pop(context);
                              Navigator.pop(context);
                            }),
                      )
                    ],
                  ),
                ),
              ),
            );
          });
        });
  }

  messageDialog(String message, BuildContext _context) {
    showDialog(
      barrierDismissible: true,
      context: _context,
      builder: (BuildContext context) {
        return AlertDialog(
          shape: RoundedRectangleBorder(
            borderRadius: BorderRadius.circular(15.0),
          ),
          content: Stack(
            children: <Widget>[
              StatefulBuilder(
                builder: (BuildContext context, StateSetter alertState) {
                  return Container(
                      child: Column(
                    mainAxisAlignment: MainAxisAlignment.center,
                    crossAxisAlignment: CrossAxisAlignment.center,
                    mainAxisSize: MainAxisSize.min,
                    children: <Widget>[
                      Padding(
                        padding: EdgeInsets.only(left: 8.0),
                        child: Text(
                          message,
                          textAlign: TextAlign.center,
                          style: TextStyle(
                            fontFamily: "Montserrat",
                            fontSize: 16.0,
                            color: Colors.black,
                          ),
                        ),
                      ),
                      Padding(
                        padding: const EdgeInsets.only(top: 16),
                        child: Container(
                          decoration: BoxDecoration(
                            borderRadius: BorderRadius.circular(15),
                          ),
                          child: ElevatedButton(
                            onPressed: () {
                              Navigator.pop(context);
                            },
                            child: Text(
                              "Ok",
                              style: TextStyle(fontSize: 15, color: Colors.white),
                            ),
                          ),
                        ),
                      ),
                    ],
                  ));
                },
              ),
            ],
          ),
        );
      },
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
        appBar: AppBar(
          title: const Text('Esp Ble Provisioning'),
          backgroundColor: Colors.blue,
        ),
        body: !isLoading
            ? isScanned
                ? Container(
                    padding: EdgeInsets.all(16),
                    child: Column(
                      children: [
                        Text(
                          "Select a device for provisioning",
                          style: TextStyle(
                              color: Colors.black,
                              fontWeight: FontWeight.bold,
                              fontSize: 18),
                        ),
                        Padding(
                          padding: const EdgeInsets.only(top: 16.0),
                          child: ListView.builder(
                              shrinkWrap: true,
                              itemCount: devices.length,
                              itemBuilder: (_context, index) {
                                return GestureDetector(
                                    onTap: () {
                                      _showPOPDialog(context, index);
                                    },
                                    child: Container(
                                      width: double.infinity,
                                      child: Column(
                                        mainAxisAlignment:
                                            MainAxisAlignment.start,
                                        crossAxisAlignment:
                                            CrossAxisAlignment.start,
                                        children: [
                                          Padding(
                                            padding: const EdgeInsets.all(4.0),
                                            child: Text(
                                              devices[index].name,
                                              style: TextStyle(
                                                  fontSize: 16,
                                                  color: Colors.black),
                                            ),
                                          ),
                                          Padding(
                                            padding: const EdgeInsets.all(4.0),
                                            child: Text(
                                              devices[index].id,
                                              style: TextStyle(
                                                  fontSize: 14,
                                                  color: Colors.grey),
                                            ),
                                          ),
                                        ],
                                      ),
                                    ));
                              }),
                        ),
                      ],
                    ))
                : Container(
                    height: double.infinity,
                    child: Center(
                      child: ElevatedButton(
                        onPressed: () async {
                          print("scan clicked");
                          await startListening();
                          if (bleEnabled) {
                            scanBleDevice();
                          }
                          // _wifiDialog()
                        },
                        child: Text("Scan for bluetooth device"),
                      ),
                    ),
                  )
            : Align(
                alignment: Alignment.center,
                child: Container(
                  padding: EdgeInsets.only(top: 250),
                  color: Colors.white,
                  child: Center(
                    child: Column(
                      children: [
                        SpinKitRipple(
                            color: Theme.of(context).colorScheme.secondary),
                        Padding(
                          padding: const EdgeInsets.all(8.0),
                          child: Text(
                            loading!,
                            style: TextStyle(
                              fontSize: 14,
                            ),
                          ),
                        )
                      ],
                    ),
                  ),
                ),
              ));
  }
}

class BleDevices {
  String name;
  String id;

  BleDevices(this.name, this.id);

  [@override](/user/override)
  String toString() {
    return '{ ${this.name}, ${this.id} }';
  }
}

String _getStatusFromKey(ProvisionState key) {
  print(key);
  switch (key) {
    case ProvisionState.CREATE_SESSION_FAILED:
      return "Failed to establish session with device";
    case ProvisionState.WIFI_CONFIG_SENT:
      return "Wifi credentials sent to device";
    case ProvisionState.WIFI_CONFIG_FAILED:
      return "Wifi credentials failed";
    case ProvisionState.WIFI_CONFIG_APPLIED:
      return "Wifi credentials applied to device";
    case ProvisionState.DEVICE_PROVISIONING_SUCCESS:
      return "Device provisioned successfully";
    default:
      return "Device provisioning failed";
  }
}

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

vueper 1楼

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

stratosfy_esp_ble_provisioning 是一个用于在 Flutter 应用中与 ESP32 设备进行蓝牙配置的插件。它允许你通过蓝牙将 Wi-Fi 凭据发送到 ESP32 设备，以便设备可以连接到指定的 Wi-Fi 网络。以下是使用该插件的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 stratosfy_esp_ble_provisioning 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  stratosfy_esp_ble_provisioning: ^1.0.0  # 请使用最新版本

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

2. 初始化插件

在你的 Dart 代码中，导入插件并初始化它：

import 'package:stratosfy_esp_ble_provisioning/stratosfy_esp_ble_provisioning.dart';

final bleProvisioning = StratosfyEspBleProvisioning();

3. 扫描并连接设备

使用 scanDevices 方法扫描附近的蓝牙设备，并选择要连接的设备：

void scanAndConnect() async {
  try {
    final devices = await bleProvisioning.scanDevices();
    if (devices.isNotEmpty) {
      final device = devices.first; // 选择第一个设备
      await bleProvisioning.connect(device);
      print('Connected to device: ${device.name}');
    }
  } catch (e) {
    print('Error scanning or connecting: $e');
  }
}

4. 发送 Wi-Fi 凭据

连接成功后，使用 sendWifiCredentials 方法将 Wi-Fi 凭据发送到设备：

void sendWifiCredentials() async {
  try {
    await bleProvisioning.sendWifiCredentials(
      ssid: 'YourWifiSSID',
      password: 'YourWifiPassword',
    );
    print('Wi-Fi credentials sent successfully');
  } catch (e) {
    print('Error sending Wi-Fi credentials: $e');
  }
}

5. 断开连接

完成配置后，断开与设备的连接：

void disconnect() async {
  try {
    await bleProvisioning.disconnect();
    print('Disconnected from device');
  } catch (e) {
    print('Error disconnecting: $e');
  }
}

6. 处理错误和状态

在使用过程中，你可能会遇到各种错误或状态变化。插件提供了回调来处理这些事件：

bleProvisioning.onStateChanged.listen((state) {
  print('State changed: $state');
});

bleProvisioning.onError.listen((error) {
  print('Error occurred: $error');
});

7. 示例代码

以下是一个完整的示例代码，展示了如何使用 stratosfy_esp_ble_provisioning 插件：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

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

class _HomeScreenState extends State<HomeScreen> {
  final bleProvisioning = StratosfyEspBleProvisioning();

  [@override](/user/override)
  void initState() {
    super.initState();
    bleProvisioning.onStateChanged.listen((state) {
      print('State changed: $state');
    });

    bleProvisioning.onError.listen((error) {
      print('Error occurred: $error');
    });
  }

  void scanAndConnect() async {
    try {
      final devices = await bleProvisioning.scanDevices();
      if (devices.isNotEmpty) {
        final device = devices.first;
        await bleProvisioning.connect(device);
        print('Connected to device: ${device.name}');
      }
    } catch (e) {
      print('Error scanning or connecting: $e');
    }
  }

  void sendWifiCredentials() async {
    try {
      await bleProvisioning.sendWifiCredentials(
        ssid: 'YourWifiSSID',
        password: 'YourWifiPassword',
      );
      print('Wi-Fi credentials sent successfully');
    } catch (e) {
      print('Error sending Wi-Fi credentials: $e');
    }
  }

  void disconnect() async {
    try {
      await bleProvisioning.disconnect();
      print('Disconnected from device');
    } catch (e) {
      print('Error disconnecting: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('ESP32 BLE Provisioning'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: scanAndConnect,
              child: Text('Scan and Connect'),
            ),
            ElevatedButton(
              onPressed: sendWifiCredentials,
              child: Text('Send Wi-Fi Credentials'),
            ),
            ElevatedButton(
              onPressed: disconnect,
              child: Text('Disconnect'),
            ),
          ],
        ),
      ),
    );
  }
}