开发
Meta XR 模拟工具概览
更新时间: 2025年11月13日
Standalone XR Simulator
本文档介绍了新发布的独立式 XR 模拟工具。旧版本的 Meta 核心 SDK 可能无法完全兼容。如果遇到问题，请从项目中移除“com.meta.xr.simulator”包，然后使用 Meta XR 模拟工具中的切换按钮，将其设置为 OpenXR 活跃 Runtime。关于旧版的使用方法，请参阅已归档的 XR 模拟工具文档。Meta XR 模拟工具是为开发者打造的一个轻量级 OpenXR 运行时工具，可以在 API 层级模拟 Meta Quest 头戴设备和功能。它作为一款综合测试与开发工具，让您能够直接在开发设备上模拟 Meta Quest 体验，其本质上是一台在电脑上运行的虚拟 Meta Quest 头戴设备。该模拟工具针对 XR 应用程序实现了 OpenXR 标准，因此可兼容任何 OpenXR 应用程序，包括使用 Unity 构建的应用程序。
它无需频繁佩戴或摘下头戴设备即可对应用进行测试和调试，并通过简化测试环境设置来帮助实现自动化扩展。
如要下载最新版本或查看发布说明，请访问：
设备模拟
模拟 Meta Quest 设备（如 Quest 2、Quest 3 和 Quest Pro），包括：
- 具备设备专属特性的立体渲染功能
- 头戴设备和控制器追踪
- 手势追踪
- 身体追踪
- 输入系统（控制器、手势）
合成环境
运行应用程序的虚拟空间。
使用实体 Meta Quest 头戴设备时，应用程序会与周围的真实世界互动。头戴设备通过摄像头捕捉房间内的环境信息，检测墙壁和家具，并启用透视功能，让您能够看到周围的环境。在 Meta XR 模拟工具中，合成环境可以实现相同作用。合成环境是指预先创建的 3D 房间，以提供：
- 透视数据：“物理”空间的视觉呈现
- 场景信息：空间感知内容，包括墙壁、地面、天花板、家具、门和窗户
- 空间锚点：您可以在环境中附加虚拟对象的位置
- 深度数据：用于实现逼真互动效果的距离信息
如果没有合成环境，您的应用程序将缺少可与之互动的“物理世界”。合成环境对于将虚拟内容与实际环境相融合的混合现实应用而言，尤其重要。
主要功能
输入模拟
通过开发设备控制模拟的头戴设备和手势：
- 键盘和鼠标：将键盘和鼠标操作映射为头戴设备和控制器的运动指令
- Xbox 控制器：使用熟悉的游戏手柄控制
- 手势追踪：测试手部姿势，包括捏拉、戳和拿取
- 连接实体控制器：在模拟工具中使用真实的 Meta Quest 控制器
如需了解更多信息，请参阅输入模拟。
合成环境
无需离开工位，即可在多种房间布局下测试应用程序：
- 内置房间：游戏室、客厅、卧室等
如需了解更多信息，请参阅合成环境。
会话捕捉（录制和重播）
实现重复性测试任务的自动化执行：
- 录制用户操作：一次性捕捉互动操作
- 重播会话内容：自动重播操作，以保障测试的一致性
- 零代码自动化：基础测试自动化，无需编写脚本
- CI/CD 集成：在持续集成管道中运行自动测试
如需了解更多信息，请参阅会话捕捉（录制和重播）。
多玩家测试
在一台设备上测试多玩家体验：
- 多会话模式：同时运行多个会话，并支持在会话间自由切换
- 共享环境：所有会话均连接至同一合成环境
如需了解更多信息，请参阅多玩家测试。
用户界面
您需通过窗口界面与 Meta XR 模拟工具进行互动。窗口外观取决于您是否在模拟工具中运行应用程序。
注意：您可以将光标悬停在模拟工具窗口中的任意元素上，以查看附带更多信息的工具提示。
XR 模拟工具窗口
首次启动 XR 模拟工具时
当您启动 XR 模拟工具而未运行任何应用程序时，窗口会显示一条消息，并提供基本设置的访问入口：
- 从可用选项中选择合成环境
- 配置模拟工具基本设置
- 在系统中全局激活模拟工具
当应用程序运行时
在模拟工具中启动应用程序后，窗口会切换为完全互动式，并显示以下内容：
- 视口：显示头戴设备呈现内容的主要视图（默认为左眼视图）
- 工具栏：顶部的控制栏，包含状态指示标和打开不同面板的按钮
- 侧边面板：点击工具栏按钮时，在右侧打开的信息和控制面板
- 控制台：用于查看 Meta XR 模拟工具运行消息的日志区域（默认为隐藏状态）
工具栏
工具栏横贯模拟工具窗口顶部，可快速查看状态信息并调用各项控制功能：
左侧区域：连接和激活
- 连接状态指示器：通过一个圆点，用以显示测试中的应用程序是否已成功连接至模拟工具
- 全局激活滑块：用于在系统中全局激活模拟工具，这意味着任何 OpenXR 应用程序都将自动尝试连接至该模拟工具
中间区域：侧边面板触发按钮
打开特定侧边面板的按钮。点击按钮可打开其对应的面板，这些面板将出现在窗口右侧。可用面板包括：
- 设置
- 录制和重播
- 输入
- 输入绑定
- 控制台
右侧区域：系统功能
- 信息按钮：显示有关已连接应用程序、已启用扩展功能以及配置文件存储路径的信息
- 帮助按钮：访问文档和支持资源
- 反馈按钮：提交关于模拟工具的反馈
- 合成环境选择工具：打开环境选择菜单，选择不同的合成房间
侧边面板
侧边面板提供详细的控制选项和信息。当从工具栏启用时，相关面板会在窗口右侧显示。
设置面板
配置模拟设备属性：
- 设备型号：可选设备型号包括 Quest 2、Quest 3、Quest Pro 以及其他受支持的设备型号
- IPD（瞳距）：调整眼睛之间的距离
- 刷新率：设置显示器的刷新率
注意：部分更改仅在重启该模拟工具后生效。
录制和重播面板
通过录制和重播用户操作来实现测试自动化：
- 录制：捕捉测试会话期间的一系列操作
- 保存：在本地存储录制内容，以备后续使用
- 重播：重新播放录制的会话，以便开展一致、可重复的测试
如需了解详细信息，请参阅捕捉 Meta XR 模拟工具会话。
输入面板
控制 Meta XR 模拟工具中模拟输入的方式：
- 全局输入设置：选择追踪系统的哪些部分处于启用状态：
- 头戴设备运动
- 左手/控制器
- 右手/控制器 - 该选项在特定场景下尤为重要，例如仅需单手完成互动操作的场景
- 键盘 + 鼠标：您可在此启用“点选”功能
- 实体控制器：将 Quest 控制器连接至模拟工具
- Xbox 控制器：适配 Xbox 控制器的控制器模拟工具
- 运动追踪控制：您可以将其用于重播记录的追踪数据来测试 MovementSDK 功能，例如身体、面部和视线追踪。
输入绑定面板
- 查看和自定义键盘与控制器的映射关系
- 查看分配给每个操作（如前进、转向或拿取）的按键或按钮
- 自定义按键或按钮配置，以满足您的偏好。
控制台面板
查看 Meta XR 模拟工具日志与诊断信息。
入门指南
有关在您的开发环境中设置并安装 Meta XR 模拟工具的指导，请参阅 Meta XR 模拟工具。
虚拟现实 / Meta Horizon
虚拟现实 / Meta Horizon
中文(简体)
© 2026 Meta