UE5 + Meta Quest 手势追踪教程：集成 Meta XR 插件并完成基础配置

本文介绍如何在 Unreal Engine 5 项目中安装 Meta XR 插件、配置目标 Quest 设备并开启手势追踪功能。示例配置适用于Meta Quest 3SMeta Quest 3Meta Quest ProUnreal Engine 5.5一、Meta XR 与 Meta XR Platform 的区别在插件列表中可能会同时看到Meta XR和Meta XR Platform。两者用途不同插件主要用途手势追踪是否需要Meta XR头显、控制器、手势追踪、渲染、OpenXR 扩展和 MR 功能需要Meta XR Platform用户账号、授权校验、成就、排行榜、房间、匹配和内购等平台服务不需要只实现 Quest 设备运行和手势追踪时启用Meta XR即可不需要启用Meta XR Platform。Meta XR Platform 还涉及 App ID、用户授权和 Data Use Checkup 等平台服务配置不应仅因为名称相似而开启。可参考 Meta XR Platform 官方配置说明。二、安装 Meta XR 插件如果项目使用 Epic Games Launcher 安装的 Unreal Engine可以单独安装与当前 UE 版本匹配的 Meta XR 插件。安装步骤如下从 Meta 官方开发者页面下载对应 Unreal Engine 版本的 Meta XR 插件。解压下载的压缩包。将插件目录复制到[Unreal Engine 安装目录]\Engine\Plugins\Marketplace例如C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\Marketplace启动 Unreal Editor。打开编辑 插件。搜索Meta XR。启用 Meta XR 插件。按提示重新启动 Unreal Editor。插件版本必须与 Unreal Engine 版本匹配。为其他 UE 版本编译的插件可能出现模块无法加载、编译失败或编辑器启动报错。Meta 官方同时说明可下载的 Meta XR 插件不通过 Epic Games Marketplace 发布。详细步骤参见 Meta XR 插件安装文档。三、配置支持的 Quest 设备打开编辑 项目设置 插件 Meta XR找到移动平台配置中的Supported Meta Quest devices添加以下四个设备Meta Quest 3S Meta Quest 3 Meta Quest Pro Meta Quest 2如果项目只面向部分设备也可以只保留实际支持的型号。设备列表应与项目经过测试并计划发布的平台保持一致。四、开启手势追踪仍然在编辑 项目设置 插件 Meta XR找到手势追踪相关配置。Hand Tracking Support设置为Controllers and Hands该选项允许应用同时支持 Touch 控制器和手势追踪并根据当前输入设备进行切换。Meta XR 提供三种模式设置说明Controllers Only只允许使用控制器不开启手势追踪Controllers and Hands同时支持控制器和手势追踪Hands Only应用只能使用手势交互一般项目推荐使用Controllers and Hands。这样即使手势追踪暂时丢失用户仍然可以拿起控制器继续操作。选择支持手势追踪的模式后Meta XR 插件会为 Android 应用配置相应的手势追踪权限。参见 Meta 官方手势追踪配置。Hand Tracking Frequency设置为HIGHHIGH会请求更高的手部追踪更新频率适合对响应速度要求较高的交互例如快速捏合节奏游戏健身应用快速触碰或抓取更高频率会占用更多性能和功耗预算也可能降低时间平滑带来的稳定效果。因此如果应用中的手势动作较慢可以对比测试LOW和HIGH后再决定。需要注意该设置本质上是向运行时提交频率建议系统仍可能根据性能、温度或电源状态进行调整。Meta 的高频手势追踪说明也明确指出高频请求不保证始终被运行时采用。Hand Tracking Version设置为V2该选项指定项目使用 V2 手势追踪算法。完成后三项关键配置应为Hand Tracking Support Controllers and Hands Hand Tracking Frequency HIGH Hand Tracking Version V2修改设置后建议保存项目并重新启动 Unreal Editor。五、使用 Meta XR Project Setup ToolMeta XR 插件提供了 Project Setup Tool用于检查项目是否满足 Quest 构建要求。打开工具 Meta XR Project Setup Tool也可以从 Meta XR 项目设置页面或编辑器底部的 Meta 状态图标进入。检查步骤打开 Meta XR Project Setup Tool。选择 Android 或 Meta Quest 目标平台。等待工具扫描项目配置。查看未完成的 Required、Recommended 或 Compatibility 项。展开检查项确认工具将修改的设置。单独应用需要的修复或使用Apply All批量应用。保存项目。如果工具要求重启编辑器则完成重启。再次打开工具确认必须项已经通过。Project Setup Tool 会使用一组配置规则检查工程并帮助项目达到 Quest Ready 状态。它可能调整 Android、渲染、打包和 Meta XR 插件相关设置因此已有项目在执行Apply All前应先查看修改内容。Meta 官方说明Quest 的渲染、Mobile HDR、Vulkan 和打包等关键设置可以通过 Meta XR 插件及其 Project Setup Tool 完成检查和配置。Meta Quest 项目配置说明。六、配置检查清单完成以上步骤后可以根据下面的列表进行核对Meta XR 插件已安装并启用插件版本与 Unreal Engine 版本匹配没有误把 Meta XR Platform 当作手势追踪插件OpenXR 相关依赖正常加载Supported Meta Quest devices 已配置Quest 3S 已添加Quest 3 已添加Quest Pro 已添加Hand Tracking Support 为Controllers and HandsHand Tracking Frequency 为HIGHHand Tracking Version 为V2Project Setup Tool 的必要检查项已经通过修改设置后已保存并重启编辑器完成这些配置后项目就具备了在 Meta Quest 设备上使用控制器和手势追踪的基础条件。后续可以继续添加OculusXRHandComponent、配置左右手模型并通过 Pinch 输入实现具体的手势交互。