Flutter蓝牙通信插件flutter_beacon的使用

Flutter Beacon

flutter_beacon 是一个用于与iBeacons交互的Flutter插件。它支持Android API 18+ 和 iOS 8+，提供了自动权限管理、iBeacon扫描和广播等功能。

功能特性

• 自动权限管理
• 扫描iBeacons
• 监控iBeacons
• 广播为iBeacon

安装

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

dependencies:
  flutter_beacon: latest

Android 特定设置

对于目标SDK版本29+（Android 10, 11），需要手动添加 ACCESS_FINE_LOCATION 权限：

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

如果还需要后台扫描功能，则需添加：

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

iOS 特定设置

为了使用beacon相关功能，应用需要请求位置权限。这分为两步：

1. 在配置文件中声明所需权限。
2. 在应用运行时请求用户授权（插件可以自动处理）。

在 ios/Runner/Info.plist 中声明权限：

<dict>
  <!-- When in use -->
  <key>NSLocationWhenInUseUsageDescription</key>
  <string>Reason why app needs location</string>
  <!-- Always -->
  <!-- for iOS 11 + -->
  <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
  <string>Reason why app needs location</string>
  <!-- for iOS 9/10 -->
  <key>NSLocationAlwaysUsageDescription</key>
  <string>Reason why app needs location</string>
  <!-- Bluetooth Privacy -->
  <!-- for iOS 13 + -->
  <key>NSBluetoothAlwaysUsageDescription</key>
  <string>Reason why app needs bluetooth</string>
</dict>

使用方法

Ranging API设计为响应式流。

初始化库

try {
  // 如果你想要手动检查所需的权限
  await flutterBeacon.initializeScanning;
  
  // 或者如果你想要包含自动检查权限
  await flutterBeacon.initializeAndCheckScanning;
} on PlatformException catch(e) {
  // 库初始化失败，检查错误代码和消息
}

扫描Beacons

final regions = <Region>[];

if (Platform.isIOS) {
  // iOS平台，至少设置identifier和proximityUUID进行区域扫描
  regions.add(Region(
      identifier: 'Apple Airlocate',
      proximityUUID: 'E2C56DB5-DFFB-48D2-B060-D0F5A71096E0'));
} else {
  // Android平台，它可以扫描所有Proximity UUID的beacon
  regions.add(Region(identifier: 'com.beacon'));
}

// 开始扫描beacons
_streamRanging = flutterBeacon.ranging(regions).listen((RangingResult result) {
  // result 包含一个区域和找到的beacon列表
  // 列表可以为空，如果没有找到匹配的beacon
});

// 停止扫描beacons
_streamRanging.cancel();

监控Beacons

final regions = <Region>[];

if (Platform.isIOS) {
  // iOS平台，至少设置identifier和proximityUUID进行区域监控
  regions.add(Region(
      identifier: 'Apple Airlocate',
      proximityUUID: 'E2C56DB5-DFFB-48D2-B060-D0F5A71096E0'));
} else {
  // Android平台，它可以监控所有Proximity UUID的beacon
  regions.add(Region(identifier: 'com.beacon'));
}

// 开始监控beacons
_streamMonitoring = flutterBeacon.monitoring(regions).listen((MonitoringResult result) {
  // result 包含一个区域、事件类型和事件状态
});

// 停止监控beacons
_streamMonitoring.cancel();

示例代码

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

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_beacon/flutter_beacon.dart';

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Beacon Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: BeaconHomePage(),
    );
  }
}

class BeaconHomePage extends StatefulWidget {
  @override
  _BeaconHomePageState createState() => _BeaconHomePageState();
}

class _BeaconHomePageState extends State<BeaconHomePage> {
  StreamSubscription<RangingResult>? _streamRanging;

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

  Future<void> _initializeBeacon() async {
    try {
      await flutterBeacon.initializeAndCheckScanning;
    } on PlatformException catch (e) {
      print('Failed to initialize beacon: ${e.message}');
    }
  }

  void startRangingBeacons() {
    final regions = <Region>[
      Region(identifier: 'com.beacon')
    ];

    _streamRanging?.cancel();
    _streamRanging = flutterBeacon.ranging(regions).listen((RangingResult result) {
      setState(() {
        // 更新UI逻辑
      });
    });
  }

  void stopRangingBeacons() {
    _streamRanging?.cancel();
  }

  @override
  void dispose() {
    _streamRanging?.cancel();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Beacon Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            ElevatedButton(
              onPressed: startRangingBeacons,
              child: Text('Start Ranging Beacons'),
            ),
            ElevatedButton(
              onPressed: stopRangingBeacons,
              child: Text('Stop Ranging Beacons'),
            ),
          ],
        ),
      ),
    );
  }
}

此示例代码创建了一个简单的Flutter应用程序，其中包含两个按钮：一个用于开始扫描附近的iBeacons，另一个用于停止扫描。当点击“Start Ranging Beacons”按钮时，程序将启动对指定区域内iBeacons的扫描，并在控制台输出结果；点击“Stop Ranging Beacons”按钮则会取消当前正在进行的扫描任务。

请注意，在实际开发过程中，您可能需要根据具体需求调整UI布局以及处理扫描到的数据。此外，确保按照上述说明正确配置了iOS和Android项目的权限设置。