Flutter位置服务插件 at_location_flutter 的使用

at_location_flutter 是一个用于在Flutter应用中实现位置共享功能的插件。它允许两个atsign之间共享和接收位置信息，基于去中心化的atPlatform模型，提供端到端加密等特性。

概述

该插件支持以下特性：

• 通过个人数据存储进行数据访问的加密控制
• 不需要应用程序后端
• 端到端加密，只有数据所有者拥有密钥
• 私有且无监控的连接
• 共享位置并在地图上查看

更多关于atPlatform的工作原理，请参考 官方文档。

快速开始

1. 使用 at_app 创建示例应用

$ flutter pub global activate at_app 
$ at_app create --sample=<package ID> <app name>
$ cd <app name>
$ flutter run

注意：

• 你只需要运行一次 flutter pub global activate
• Windows用户请使用 at_app.bat

2. 从GitHub克隆源码

可以从 GitHub仓库 克隆源码。

$ git clone https://github.com/atsign-foundation/at_widgets.git

3. 手动添加包到项目

可以按照 pub.dev 上的说明手动添加包。

设置与初始化

初始化

首先需要通过Onboarding widget对atsign进行身份验证，然后初始化位置服务：

await initializeLocationService(
  navKey,
  mapKey: 'xxxx', // 替换为你的MapTiler API key
  apiKey: 'xxxx', // 替换为你的HERE API key
  showDialogBox: true,
  streamAlternative: (__){},
  isEventInUse: true, 
);

权限设置

iOS: 在 ios/Runner/Info.plist 中添加：

<key>NSLocationWhenInUseUsageDescription</key>
<string>Explain the description here.</string>

Android: 在 android/app/src/main/AndroidManifest.xml 中添加：

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

使用方法

分享位置

分享位置给某个atsign 30分钟：

sendShareLocationNotification(receiver, 30);

请求位置

向某个atsign请求位置：

sendRequestLocationNotification(receiver);

查看位置

查看多个atsign的位置：

AtLocationFlutterPlugin(
  ['atsign1', 'atsign2', ...]
)

使用默认地图视图

Navigator.push(
      context,
      MaterialPageRoute(
          builder: (context) => MapScreen(
                currentAtSign: AtLocationNotificationListener().currentAtSign,
                userListenerKeyword: locationNotificationModel,
              )),
    );

使用默认主页视图

Navigator.push(
      context,
      MaterialPageRoute(
        builder: (BuildContext context) => HomeScreen(),
    ));

数据类型

• LocationNotificationModel: 包含共享或请求位置的详细信息。
• LocationDataModel: 包含实际地理位置和其他详细信息。
• KeyLocationModel: 用于跟踪所有共享或请求通知。

获取API Keys

获取Map Key

1. 访问 MapTiler
2. 登录或创建免费账户
3. 返回 MapTiler
4. 复制嵌入式查看器中的key（例如：https://api.maptiler.com/maps/streets/?key=YOUR_MAP_KEY#-0.1/-2.80318/-38.08702）
5. 将 YOUR_MAP_KEY 替换并使用

获取API Key

访问 HERE开发者指南 并按照步骤获取API Key。

示例代码

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

import 'dart:async';
import 'package:at_app_flutter/at_app_flutter.dart' show AtEnv;
import 'package:at_client_mobile/at_client_mobile.dart';
import 'package:at_onboarding_flutter/at_onboarding_flutter.dart'
    show AtOnboarding, AtOnboardingConfig, AtOnboardingResultStatus;
import 'package:flutter/material.dart';
import 'package:path_provider/path_provider.dart' show getApplicationSupportDirectory;

Future<void> main() async {
  await AtEnv.load();
  runApp(const MyApp());
}

Future<AtClientPreference> loadAtClientPreference() async {
  var dir = await getApplicationSupportDirectory();
  return AtClientPreference()
        ..rootDomain = AtEnv.rootDomain
        ..namespace = AtEnv.appNamespace
        ..hiveStoragePath = dir.path
        ..commitLogPath = dir.path
        ..isLocalStoreRequired = true;
}

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  Future<AtClientPreference> futurePreference = loadAtClientPreference();
  AtClientPreference? atClientPreference;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      navigatorKey: NavService.navKey,
      theme: ThemeData().copyWith(
        brightness: Brightness.light,
        primaryColor: const Color(0xFFf4533d),
        colorScheme: ThemeData.light().colorScheme.copyWith(
              primary: const Color(0xFFf4533d),
            ),
        bottomAppBarTheme: const BottomAppBarTheme(color: Colors.white),
        scaffoldBackgroundColor: Colors.white,
      ),
      darkTheme: ThemeData().copyWith(
        brightness: Brightness.dark,
        primaryColor: Colors.blue,
        colorScheme: ThemeData.dark().colorScheme.copyWith(
              primary: Colors.blue,
            ),
        bottomAppBarTheme: BottomAppBarTheme(color: Colors.grey[850]),
        scaffoldBackgroundColor: Colors.grey[850],
      ),
      home: Scaffold(
        appBar: AppBar(
          title: const Text('at_location example'),
          actions: <Widget>[
            IconButton(
              onPressed: () {},
              icon: Icon(
                Theme.of(context).brightness == Brightness.light
                    ? Icons.dark_mode_outlined
                    : Icons.light_mode_outlined,
              ),
            )
          ],
        ),
        body: Builder(
          builder: (context) => Center(
            child: Column(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                ElevatedButton(
                  onPressed: () async {
                    var preference = await futurePreference;
                    setState(() {
                      atClientPreference = preference;
                    });
                    final result = await AtOnboarding.onboard(
                      context: context,
                      config: AtOnboardingConfig(
                        atClientPreference: atClientPreference!,
                        domain: AtEnv.rootDomain,
                        rootEnvironment: AtEnv.rootEnvironment,
                        appAPIKey: AtEnv.appApiKey,
                      ),
                    );
                    if (result.status == AtOnboardingResultStatus.success) {
                      Navigator.push(context, MaterialPageRoute(builder: (_) => const SecondScreen()));
                    }
                  },
                  child: const Text('Onboard an atSign'),
                ),
                const SizedBox(height: 10),
                ElevatedButton(
                  onPressed: () async {
                    var preference = await futurePreference;
                    atClientPreference = preference;
                    AtOnboarding.reset(
                      context: context,
                      config: AtOnboardingConfig(
                        atClientPreference: atClientPreference!,
                        domain: AtEnv.rootDomain,
                        rootEnvironment: AtEnv.rootEnvironment,
                        appAPIKey: AtEnv.appApiKey,
                      ),
                    );
                  },
                  child: const Text('Reset'),
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}

class NavService {
  static GlobalKey<NavigatorState> navKey = GlobalKey();
}