Flutter增强现实位置查看插件ar_location_viewer的使用

ar_location_viewer

增强现实地理定位功能。灵感来源于 HDAugmentedReality。

它是 ar_location_view 的升级版。

升级后的依赖项：

Demo

描述

ArLocationViewer 设计用于具有大量静态兴趣点（POI）的区域，主要目标是使所有 POI 可见。

备注: POI 的海拔高度被忽略。

特性

• 自动垂直堆叠注解视图
• 跟踪用户移动并更新可见注解
• 支持完全自定义的注解视图
• 支持所有旋转

基本用法

查看示例代码。

iOS 平台

ArLocationView 使用设备摄像头和位置信息，在 Info.plist 中添加以下内容：

<key>NSLocationWhenInUseUsageDescription</key>
<string>需要您的位置来显示POI。</string>
<key>NSLocationUsageDescription</key>
<string>需要您的位置来显示POI。</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>需要您的位置来显示POI。</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>需要您的位置来显示POI。</string>
<key>NSCameraUsageDescription</key>
<string>需要访问相机来显示AR视图。</string>

Android 平台

在 AndroidManifest.xml 中添加以下权限：

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

<!-- 如果出现异常，则需要添加以下权限 -->
<uses-permission android:name="android.permission.HIGH_SAMPLING_RATE_SENSORS"/>

如果遇到类似以下异常：

PlatformException(error, To use the sampling rate of 500 microseconds, app needs to declare the normal permission HIGH_SAMPLING_RATE_SENSORS., null, null)

请在 AndroidManifest.xml 中添加：

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

创建一个扩展 ArAnnotation 的类：

class Annotation extends ArAnnotation {
  final AnnotationType type;
  
  Annotation({required super.uid, required super.position, required this.type});
}

创建一个用于注解视图的小部件，例如：

class AnnotationView extends StatelessWidget {
  const AnnotationView({
    Key? key,
    required this.annotation,
  }) : super(key: key);

  final Annotation annotation;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Container(
      decoration: BoxDecoration(
        borderRadius: BorderRadius.circular(5),
        color: Colors.white,
      ),
      child: Row(
        children: [
          Expanded(
            child: Container(
              decoration: const BoxDecoration(
                borderRadius: BorderRadius.only(
                  topLeft: Radius.circular(5),
                  bottomLeft: Radius.circular(5),
                ),
              ),
              child: typeFactory(annotation.type),
            ),
          ),
          Expanded(
            flex: 2,
            child: Padding(
              padding: const EdgeInsets.all(4.0),
              child: Column(
                crossAxisAlignment: CrossAxisAlignment.start,
                mainAxisAlignment: MainAxisAlignment.spaceBetween,
                children: [
                  Text(
                    annotation.type.toString().substring(15),
                    maxLines: 1,
                    style: const TextStyle(fontWeight: FontWeight.bold),
                  ),
                  Text(
                    '${annotation.distanceFromUser.toInt()} m',
                  ),
                ],
              ),
            ),
          )
        ],
      ),
    );
  }

  Widget typeFactory(AnnotationType type) {
    IconData iconData = Icons.ac_unit_outlined;
    Color color = Colors.teal;
    switch (type) {
      case AnnotationType.pharmacy:
        iconData = Icons.local_pharmacy_outlined;
        color = Colors.red;
        break;
      case AnnotationType.hotel:
        iconData = Icons.hotel_outlined;
        color = Colors.green;
        break;
      case AnnotationType.library:
        iconData = Icons.library_add_outlined;
        color = Colors.blue;
        break;
    }
    return Icon(
      iconData,
      size: 40,
      color: color,
    );
  }
}

许可证

ArLocationViewer 是根据 MIT 许可证发布的。

示例代码

以下是完整的示例代码：

import 'package:flutter/material.dart';
import 'package:ar_location_viewer/ar_location_viewer.dart';
import 'package:geolocator/geolocator.dart';
import 'annotation_viewer.dart';
import 'annotations.dart';

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

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

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

class _MyAppState extends State<MyApp> {
  List<Annotation> annotations = [];

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: ArLocationWidget(
          annotations: annotations,
          showDebugInfoSensor: false,
          annotationViewerBuilder: (context, annotation) {
            return AnnotationViewer(
              key: ValueKey(annotation.uid),
              annotation: annotation as Annotation,
            );
          },
          onLocationChange: (Position position) {
            Future.delayed(const Duration(seconds: 5), () {
              annotations = fakeAnnotation(position: position, numberMaxPoi: 50);
              setState(() {});
            });
          },
        ),
      ),
    );
  }
}