Flutter蓝牙通信插件smartble_sdk的使用

概述

smartble_sdk 是一个用于 Flutter 的蓝牙通信插件。它支持 Android 和 iOS 平台，并允许开发者轻松实现蓝牙设备的扫描、连接和数据传输功能。

使用步骤

1. 添加依赖

在 pubspec.yaml 文件中添加 smartble_sdk 依赖：

dependencies:
  smartble_sdk: ^1.0.0

运行以下命令以安装依赖：

flutter pub get

2. 初始化插件

在项目中创建一个状态管理类来初始化和操作 SmartbleSdk。

示例代码

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

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final smartble = SmartbleSdk();

  @override
  void initState() {
    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Bluetooth Communication Example'),
        ),
        body: Padding(
          padding: const EdgeInsets.all(16.0),
          child: ListView(
            shrinkWrap: true,
            children: [
              // 扫描按钮
              TextButton(
                onPressed: () {
                  smartble.scan(isScan: true);
                },
                child: const Text("Scan"),
              ),

              // 显示扫描结果
              StreamBuilder<dynamic>(
                stream: SmartbleSdk.getDeviceListStream,
                builder: (BuildContext context, AsyncSnapshot<dynamic> snapshot) {
                  if (snapshot.connectionState == ConnectionState.waiting) {
                    return Container();
                  } else if (snapshot.connectionState == ConnectionState.active ||
                              snapshot.connectionState == ConnectionState.done) {
                    if (snapshot.hasError) {
                      return const Text(
                        'Error',
                        style: TextStyle(fontSize: 16, color: Colors.black, fontWeight: FontWeight.normal),
                        textAlign: TextAlign.center,
                      );
                    } else if (snapshot.hasData) {
                      List listdata = snapshot.data ?? [];
                      return ListView.builder(
                        itemCount: listdata.length,
                        shrinkWrap: true,
                        itemBuilder: (context, i) {
                          return Padding(
                            padding: const EdgeInsets.all(16.0),
                            child: InkWell(
                              onTap: () {
                                // 设置设备地址并连接
                                smartble.setAddress(
                                  bname: "${listdata[i]['deviceName']}",
                                  bmac: "${listdata[i]['deviceMacAddress']}",
                                );
                                smartble.connect();
                              },
                              child: Text(
                                "${listdata[i]['deviceName']} ${listdata[i]['deviceMacAddress']}",
                                style: const TextStyle(fontSize: 16, color: Colors.black, fontWeight: FontWeight.bold),
                                textAlign: TextAlign.start,
                              ),
                            ),
                          );
                        },
                      );
                    } else {
                      return const Text(
                        'Empty Data',
                        style: TextStyle(fontSize: 16, color: Colors.black, fontWeight: FontWeight.normal),
                        textAlign: TextAlign.center,
                      );
                    }
                  } else {
                    return Text(
                      'State: ${snapshot.connectionState}',
                      style: const TextStyle(fontSize: 16, color: Colors.black, fontWeight: FontWeight.normal),
                      textAlign: TextAlign.center,
                    );
                  }
                },
              ),
            ],
          ),
        ),
      ),
    );
  }
}

3. 运行示例

将上述代码保存到 lib/main.dart 文件中，并运行以下命令启动应用：

flutter run

功能说明

1. 扫描蓝牙设备
   点击 “Scan” 按钮后，插件会开始扫描附近的蓝牙设备，并通过 Stream 实时更新扫描结果。

2. 选择设备并连接
   在扫描结果中点击某个设备，插件会自动设置设备名称和 MAC 地址，并尝试建立连接。

3. 错误处理
   如果发生错误（例如未找到设备或连接失败），界面会显示错误信息。

注意事项

• 确保设备已启用蓝牙功能。
• iOS 需要配置 Info.plist 文件以请求蓝牙权限：

  <key>NSBluetoothAlwaysUsageDescription</key>
  <string>We need access to your Bluetooth to connect devices.</string>