Unity AR Foundation 跨平台AR开发

可视化演示

展示AR Foundation的平面检测与锚点定位、ARCore/ARKit统一架构、环境光照估计与手势交互三大核心能力。

跨平台架构：一个插头，两个国家的插座

你拖着行李箱走进美国酒店，掏出万能插头插进扁脚插座，手机开始充电；第二天飞到欧洲，换一个方向，圆脚插座同样能充电。你不需要带两套充电器，因为转换插头把“墙后面的电”统一成了同一个输出。AR 开发也如此：Android 的墙后面是 ARCore，iOS 的墙后面是 ARKit，两者追踪算法不同、接口不同，但你的产品希望跑到两个国家。

ARCore 是 Google 的移动 AR 平台，基于特征点与惯性测量实现位姿追踪；ARKit 是 Apple 的 AR 平台，强调视觉惯性里程计与场景理解。如果没有 AR Foundation，你要分别写两套识别、两套渲染调度。AR Foundation 是 Unity 官方提供的抽象层：它把 ARCore 和 ARKit 的能力收敛成统一的 C# 接口，ARPlaneManager、ARAnchorManager、ARLightEstimate 等组件在不同平台上自动路由到对应的原生实现。

1. 代码输入：Code_C# 代表你写的全部 C# 脚本和场景文件，它们只与 AR Foundation 的组件打交道。

$$\text{Code}_{\text{CSharp}}$$

2. 封装函数：ARF() 是 AR Foundation 这层“转换器”，负责把每一条组件调用翻译给底层 SDK。

$$\text{ARF}(\cdot)$$

3. 双端产物：等式右侧是输出集合，APK 跑在 Android 上并调用 ARCore，IPA 跑在 iOS 上并调用 ARKit，中间不需要再改业务代码。

$$\{ \text{APK}_{\text{ARCore}},\ \text{IPA}_{\text{ARKit}} \}$$

用上 AR Foundation 以后，你的团队就像只带一个万能插头的旅行者：到了 Android 国家插 ARCore 口，到了 iOS 国家插 ARKit 口，电器（应用）照常工作。这就是“跨平台架构”的核心价值：用一次开发，覆盖两个生态。

ARF( Code_C# ) = { APK_ARCore, IPA_ARKit }

环境搭建：给插头配上转换模块

万能插头买回来不能直接用，得先确认它包含哪些国家插脚的模块，也得看一下目标国家的电压范围。AR Foundation 同样如此：它不是装上就万事大吉，而是需要你完成“选模块”和“确认电压”两步，AR 会话才能真正跑起来。

在 Unity 里，你要在 Package Manager 中安装三个东西：AR Foundation 本体，以及 ARCore XR Plugin（去 Android 的转换模块）和 ARKit XR Plugin（去 iOS 的转换模块）。随后在 Build Settings 里把目标平台切到 Android 或 iOS，设置好最低 API Level（Android 建议 24 以上）和相机权限描述。接下来在场景中创建 AR Session 和 AR Session Origin 两个核心对象：前者负责会话的生命周期，后者负责把虚拟内容对齐到真实空间原点。

把环境搭建比作“拆开插头包装、装入各国模块”，那么 AR Session 状态机就是插头上的指示灯：红灯代表正在找信号，绿灯代表已经锁定，灰灯代表临时停电。搭建对了，后面所有功能才有稳定的地基。

平面检测：让插头“摸”到插座的位置

万能插头的金属弹片需要探到插座孔眼，才能咬合导电；AR 应用的虚拟物体也需要找到现实中可以“插下去”的表面，这个表面在 AR 里叫平面。平面检测做的就是：让手机摄像头在画面里找出桌面、地板、墙面这些平坦区域。

AR Foundation 的平面检测由 AR Plane Manager 驱动。原生 SDK 会持续提取画面的特征点，把这些点拟合成平面，并返回平面的中心、法线方向、边界点和尺寸。Unity 中会收到三种事件：平面新增、平面更新、平面移除。开发者通常会把检测到的平面渲染成一个半透明网格，类似可视化演示里的地面网格。

平面检测像是插头的试探动作：先伸出去碰一碰，碰到硬表面，再根据回馈确认“这里可以固定”。给你的用户一个简单的引导——“请缓慢移动手机扫描桌面”，往往比任何算法调优都更有效。

锚点系统：插入后锁紧卡扣

插头插进去之后，如果随时可能被碰掉，充电就会中断。所以好的转换插头都设计了卡扣或夹紧结构，插进去就牢牢咬住。AR 世界的“卡扣”叫锚点：它把虚拟物体钉在真实世界的一个固定位置上，即使手机移开再回来，物体也应该回到原来的地方。

AR Anchor Manager 负责锚点的创建与维护。你可以把任意 GameObject 挂上 AR Anchor 组件，AR Foundation 会在它所在的位置生成锚点；更常见的做法是先用射线检测平面，拿到命中点，再在那里放置带锚点的预制体，虚拟物体就“长”在了真实桌面上。锚点会实时接收底层跟踪数据，当相机重新定位时，锚点也会自动纠偏。

锚点是虚拟世界的地钉：卡扣没扣紧，物体就会漂移；扣紧了，杯子和桌面之间就像真的放了点胶。在实现 AR 试穿或室内导航时，先找到可信锚点，再谈后续体验。

光照估计：跟着当地亮度自动调节

你带着一个可调亮度的台灯环游世界，到了美国电压低，灯变暗；到了欧洲电压高，灯变亮。如果台灯不懂“自适应”，它要么暗得看不见，要么亮得刺眼。AR 里的虚拟物体也一样：在一个明亮的客厅里放置的 3D 台灯，如果材质亮度是固定值，放到昏暗的走廊里就会显得非常“假”。

ARCore 和 ARKit 都提供光照估计：从相机画面中解析出当前环境光的平均亮度和色温（冷光偏蓝，暖光偏黄）。Unity 的 AR Light 组件会自动把这两项数据同步到场景主光，材质再配合反射探针（Environment Probe），让虚拟物体表面出现与真实环境一致的明暗过渡和反光。

这就像台灯内置了一个光传感器：房间亮它就亮，房间暖它就暖。做 AR 试穿时，衣服色调必须随环境变化，光照估计是“虚实难分”的最后一块拼图。

手势交互：用手指给虚拟物体下达指令

万能插头上有按钮、有指示灯，你通过按键让插头完成切换；AR 手机没有物理按钮，触屏就成了天然的控制面板。用户单击、拖动、双指捏合，本质上都是在向虚拟世界下达指令。

AR Foundation 的手势交互通常分成三步：第一步通过 Unity 的 Input 系统拿到触摸点；第二步从相机发射一条射线，求出射线与检测平面的交点；第三步把这一世界坐标映射成一个操作，比如放置物体、移动锚点。捏合手势则用双指间距的变化控制缩放，旋转手势用双指连线角度的变化控制转动。为了体验好，还要加上高亮、震动、音效这类即时反馈。

手势交互就是那排按键：点一下是确定，拖一下是移动，捏一下是放大。把交互反馈做足，虚拟物体就像握在用户手里一样真实。

AI 应用场景

Python 演示

import mathfrom dataclasses import dataclassfrom typing import List, Optional @dataclassclass Plane:    center: tuple    normal: tuple    area: float    confidence: float @dataclassclass Light:    intensity: float    color_temp: float @dataclassclass Anchor:    pose: tuple    virtual_object: str = "cube" class PlatformAdapter:    """平台适配接口, 类比 AR Foundation 的抽象层"""    def detect_planes(self, frame):        raise NotImplementedError     def estimate_light(self, frame):        raise NotImplementedError     def create_anchor(self, pose):        raise NotImplementedError class AndroidAdapter(PlatformAdapter):    def detect_planes(self, frame):        return frame["android_planes"]     def estimate_light(self, frame):        return frame["android_light"]     def create_anchor(self, pose):        return Anchor(pose, "android_cube") class iOSAdapter(PlatformAdapter):    def detect_planes(self, frame):        return frame["ios_planes"]     def estimate_light(self, frame):        return frame["ios_light"]     def create_anchor(self, pose):        return Anchor(pose, "ios_cube") class ARFoundationSession:    def __init__(self, adapter):        self.adapter = adapter        self.anchors = []     def process_frame(self, frame):        planes = self.adapter.detect_planes(frame)        light = self.adapter.estimate_light(frame)        best = None        for p in planes:            if p.confidence > 0.5 and (best is None or p.area > best.area):                best = p        if best is not None and light.intensity > 1.0:            anchor = self.adapter.create_anchor(best.center)            anchor.virtual_object = "cube"            self.anchors.append(anchor)            return anchor        return None def demo():    android_frame = {        "android_planes": [Plane((0, 0, 0), (0, 1, 0), 1.2, 0.9)],        "android_light": Light(320, 5200),    }    ios_frame = {        "ios_planes": [Plane((0, 0, 0), (0, 1, 0), 1.5, 0.95)],        "ios_light": Light(310, 5100),    }    arf_a = ARFoundationSession(AndroidAdapter())    arf_i = ARFoundationSession(iOSAdapter())    result_a = arf_a.process_frame(android_frame)    result_i = arf_i.process_frame(ios_frame)    print("Android 锚点:", result_a.virtual_object if result_a else None)    print("iOS 锚点:", result_i.virtual_object if result_i else None) if __name__ == "__main__":    demo()

1. class PlatformAdapter:定义平台适配接口，对应 AR Foundation 的抽象接口层，业务代码只面对它。
2. class AndroidAdapter(PlatformAdapter):Android 端从 ARCore 帧数据中提取平面与光照，对应 ARCore XR Plugin。
3. class iOSAdapter(PlatformAdapter):iOS 端从 ARKit 帧数据中提取相同字段，对应 ARKit XR Plugin。
4. class ARFoundationSession:统一会话类，业务开发者只和它打交道。
5. best = None先假定没有可用平面，再遍历所有候选平面挑面积最大且置信度 > 0.5 的那个。
6. anchor = self.adapter.create_anchor(best.center)在最优平面中心创建锚点，对应 Unity 中点击桌面后生成 AR Anchor。
7. result_a = arf_a.process_frame(android_frame)同一个接口分别处理两个平台的数据，获得一致的锚点结果。

常见误区

面试题