Mirador 使用指南

Mirador 使用指南

Mirador Mirador makes it easy to build impressive “Point of Interest” AR experiences, on Apple's new RealityKit framework. 项目地址: https://gitcode.com/gh_mirrors/mi/Mirador

项目介绍

Mirador 是一个基于苹果 RealityKit 框架的开源库，它简化了创建令人印象深刻的“兴趣点”增强现实体验的过程。由在AR导航领域有着开创性工作的Andrew Hart开发，他曾打造过针对苹果首个AR平台 ARKit 的最大规模开源项目。现在，通过他的新企业 Hyper，Andrew将相同的技术带入零售行业。Mirador解决了AR开发中的一个关键挑战——如何在没有精确GPS定位且设备方向可能有误的情况下，准确地在AR中突出显示真实世界的位置信息。它通过视觉锚点来确定设备位置，并确保AR元素正确放置。

项目快速启动

安装

使用Swift Package Manager添加Mirador到你的项目：

File > Swift Packages > Add Package Dependency
URL: https://github.com/HyperARCo/Mirador.git

设置与运行

步骤一：配置兴趣点（POIs）

你可以通过代码或JSON文件设置兴趣点。

通过代码设置：

import Mirador

// 配置锚点
let anchorLocation = Location(coordinate: CLLocationCoordinate2D(latitude: 51.47787836, longitude: -0.00084588), altitude: 46)
let locationAnchor = LocationAnchor(name: "greenwich", physicalWidth: 0.5, location: anchorLocation, bearing: -30.radiansToDegrees, orientation: .horizontal)

// 添加兴趣点
let poi = PointOfInterest(name: "示例景点", location: CLLocation(coordinate: CLLocationCoordinate2D(latitude: 任意纬度, longitude: 任意经度)))
locationAnchor.pointsOfInterest.append(poi)

// 创建并运行Mirador视图
let miradorView = MiradorView(locationAnchor: locationAnchor)
miradorView.run()

步骤二：提供锚点图像

确保你的Assets中有清晰的锚点图像，并与LocationAnchor中的名称一致。

步骤三：运行前的准备

• 在Info.plist中添加相机权限描述 (NSCameraUsageDescription)。
• 确保在实际设备上测试，因为AR功能不支持模拟器。

应用案例与最佳实践

Mirador非常适合旅游应用、城市景观导览、天文观测等场景。通过设定特定地标作为视觉锚点，如信息板或城市标志物，开发者能够创建出精准对位的AR体验，让游客即便在复杂的环境中也能轻松找到目标景点。

示例实践

假设你在开发一款伦敦旅游应用，可以通过Mirador为每个著名景点配置AR注解，确保游客在泰晤士河畔可以准确看到塔桥的确切位置，即使他们的手机GPS稍微有点偏移。

典型生态项目

虽然Mirador本身专注于AR体验的构建，但它鼓励开发者结合其他技术如SwiftUI、ARKit的高级功能进行创意整合。例如，将Mirador集成到基于地理位置的游戏或者室内导航应用中，利用其精确的AR定位能力，丰富用户体验。开发者社区也可以探索将Mirador与其他开源项目结合的新方法，比如数据可视化工具，以创造更加沉浸式的交互展示。

---

本指南旨在快速入门Mirador项目，更深入的定制化需求和高级功能请参考项目仓库的详细文档和源码。通过实践这些步骤，开发者能够迅速启动AR项目，利用Mirador的力量，为用户提供新颖独特的AR体验。

Mirador Mirador makes it easy to build impressive “Point of Interest” AR experiences, on Apple's new RealityKit framework. 项目地址: https://gitcode.com/gh_mirrors/mi/Mirador