Flutter位置唤醒插件flutter_location_wakeup的使用

Flutter位置唤醒插件flutter_location_wakeup的使用

简介

flutter_location_wakeup 是一个Flutter插件，用于监听设备上的显著位置变化。当检测到位置变化时，前台应用程序会唤醒或保持唤醒状态。这个插件适用于需要根据位置变化保持应用活跃的场景，例如导航应用或基于位置的交互应用。

该插件的iOS实现主要依赖于Apple的 startMonitoringSignificantLocationChanges Swift API。目前，该插件仅支持iOS平台，Android支持正在开发中。

开始使用

iOS配置

为了在iOS上设置此插件，你需要请求位置权限。请在 Info.plist 文件中添加以下键值对，以描述使用位置的原因：

<key>NSLocationWhenInUseUsageDescription</key>
<string>我们需要您的位置来...</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>我们需要您的位置来...</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>我们需要您的位置来...</string>

示例用法

完整示例代码

以下是一个完整的示例代码，展示了如何使用 flutter_location_wakeup 插件来监听位置更新，并通过 SnackBar 显示位置信息。

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

// 创建一个全局的 ScaffoldMessengerState 键
final messengerStateKey = GlobalKey<ScaffoldMessengerState>();

void main() {
  runApp(MaterialApp(
    debugShowCheckedModeBanner: false,
    theme: ThemeData(useMaterial3: true),
    scaffoldMessengerKey: messengerStateKey,
    home: Scaffold(
      appBar: AppBar(
        title: const Text('获取显著位置变化'),
      ),
      body: const Center(
        child: LocationDisplay(),
      ),
    ),
  ));
}

class LocationDisplay extends StatefulWidget {
  const LocationDisplay({Key? key}) : super(key: key);

  [@override](/user/override)
  State<LocationDisplay> createState() => _LocationDisplayState();
}

class _LocationDisplayState extends State<LocationDisplay> {
  String _display = '未知'; // 初始化显示文本
  final _locationWakeup = LocationWakeup(); // 创建 LocationWakeup 实例

  [@override](/user/override)
  void initState() {
    super.initState();
    startListening(); // 启动位置监听
  }

  Future<void> startListening() async {
    if (!mounted) return; // 如果组件未挂载，直接返回

    try {
      // 在初始化之前开始监听位置更新
      _locationWakeup.locationUpdates.listen(
        (result) {
          if (!mounted) return; // 如果组件未挂载，直接返回

          setState(() => onLocationResultChange(result)); // 更新状态
        },
      );

      // 初始化位置监听
      await _locationWakeup.startMonitoring();
    } on PlatformException catch (e) {
      // 处理异常
      print('Error: ${e.message}');
    }
  }

  void onLocationResultChange(LocationResult result) {
    // 根据位置结果更新显示文本
    _display = result.match(
      onSuccess: (l) => '''
纬度: ${l.latitude}
经度: ${l.longitude}
海拔: ${l.altitude}
水平精度: ${l.horizontalAccuracy}
垂直精度: ${l.verticalAccuracy}
方向: ${l.course}
速度: ${l.speed}
时间戳: ${l.timestamp}
楼层: ${l.floorLevel}
''',
      onError: (e) => e.message,
    );

    // 显示 SnackBar 提示
    messengerStateKey.currentState?.showSnackBar(
      SnackBar(
        content: Text(
          _display,
          style: const TextStyle(fontSize: 16, fontWeight: FontWeight.bold),
        ),
        backgroundColor: Theme.of(context).colorScheme.background,
        behavior: SnackBarBehavior.floating,
        shape: RoundedRectangleBorder(
          borderRadius: BorderRadius.circular(10),
        ),
        margin: const EdgeInsets.symmetric(horizontal: 16, vertical: 8),
        duration: const Duration(seconds: 10),
        action: SnackBarAction(
          label: '关闭',
          onPressed: () {},
          textColor: Colors.white,
        ),
      ),
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) => Text(_display);
}