Flutter蓝牙信标管理插件minew_beacon_plus_flutter的使用

Flutter蓝牙信标管理插件minew_beacon_plus_flutter的使用

简介

minew_beacon_plus_flutter 是一个用于管理蓝牙信标的 Flutter 插件。它支持与蓝牙信标设备进行通信，并提供了丰富的功能来获取信标数据。

开始使用

1. 添加依赖

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

dependencies:
  minew_beacon_plus_flutter: ^版本号

运行 flutter pub get 来安装依赖。

2. 初始化插件

首先，我们需要初始化插件并检查平台版本。以下是完整的示例代码：

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

import 'package:flutter/services.dart';
import 'package:minew_beacon_plus_flutter/minew_beacon_plus_flutter.dart';

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

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

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

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown'; // 平台版本
  final _minewBeaconPlusFlutterPlugin = MinewBeaconPlus(); // 插件实例

  @override
  void initState() {
    super.initState();
    initPlatformState(); // 初始化插件
  }

  // 初始化插件状态
  Future<void> initPlatformState() async {
    String platformVersion;
    try {
      platformVersion = await _minewBeaconPlusFlutterPlugin.getPlatformVersion() ?? 'Unknown platform version';
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('蓝牙信标管理示例'),
        ),
        body: Center(
          child: Text('运行环境: $_platformVersion\n'), // 显示平台版本
        ),
      ),
    );
  }
}

3. 扫描蓝牙信标

接下来，我们实现扫描蓝牙信标的功能。以下是完整的代码示例：

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

import 'package:flutter/services.dart';
import 'package:minew_beacon_plus_flutter/minew_beacon_plus_flutter.dart';

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

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

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

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown'; // 平台版本
  List<Beacon> _beacons = []; // 存储扫描到的信标
  final _minewBeaconPlusFlutterPlugin = MinewBeaconPlus(); // 插件实例

  @override
  void initState() {
    super.initState();
    initPlatformState(); // 初始化插件
    scanBeacons(); // 启动扫描
  }

  // 初始化插件状态
  Future<void> initPlatformState() async {
    String platformVersion;
    try {
      platformVersion = await _minewBeaconPlusFlutterPlugin.getPlatformVersion() ?? 'Unknown platform version';
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  // 扫描蓝牙信标
  Future<void> scanBeacons() async {
    try {
      _minewBeaconPlusFlutterPlugin.startScan().listen((event) {
        setState(() {
          _beacons = event; // 更新信标列表
        });
      });
    } on PlatformException catch (e) {
      print("Error during scanning: $e");
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('蓝牙信标管理示例'),
        ),
        body: Column(
          children: [
            Text('运行环境: $_platformVersion\n'), // 显示平台版本
            Expanded(
              child: ListView.builder(
                itemCount: _beacons.length,
                itemBuilder: (context, index) {
                  return ListTile(
                    title: Text(_beacons[index].toString()), // 显示信标信息
                  );
                },
              ),
            ),
          ],
        ),
      ),
    );
  }
}

代码说明

1. 初始化插件：

   • 使用 initPlatformState 方法获取平台版本。
   • 插件通过 MinewBeaconPlus() 实例化。

2. 扫描信标：

   • 调用 startScan() 方法启动扫描。
   • 使用 setState 更新 UI 中的信标列表。

3. UI 展示：

   • 使用 ListView.builder 动态展示扫描到的信标信息。

注意事项

• 确保设备已启用蓝牙并允许应用访问蓝牙权限。
• 在 Android 设备上，需要在 AndroidManifest.xml 中添加蓝牙权限：

  <uses-permission android:name="android.permission.BLUETOOTH" />
  <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />