README_zh.md

English (英文) | 中文

依赖项与许可 (Prerequisites & License)

本项目基于 虚幻引擎 (Unreal Engine) 创建。

在使用本项目前，请确保您已从 unrealengine.com 获取引擎，并同意其 ���最终用户许可协议 (EULA)》。

Unreal® 是 Epic Games, Inc. 的商标或注册商标。

PICO UE5 OpenXR Plugin 示例

这是一个基于 Unreal Engine 和 PICO Unreal OpenXR Plugin 开发的VR体验Demo，旨在全面展示PICO设备在UE环境下强大的交互能力，包括手柄交互、手势识别和全身追踪。

• 如有任何问题或建议，请访问 PICO 开发者支持门户网站 提交您的问题。

---

✨ 主要功能

• 主交互中心 (Hub): 一个集中的VR主界面，允许用户通过手柄射线选择不同的体验关卡。
• 手柄交互场景: 一个功能丰富的场景，展示了移动、传送、UI交互、物体发射、远程抓取和扳机反馈等多种手柄操作。
• 手势识别场景: 无需手柄，通过自然手势即可实现粒子发射、抓取物体和场景切换等功能。
• 全身追踪场景: 实时捕捉并同步玩家的全身动作到一个虚拟形象上，提供高沉浸感的体验。

---

🛠️ 技术栈

• 虚幻引擎 (Unreal Engine): 5.4.4
• Pico Unreal OpenXR Plugin: 1.5.0

---

🎮 操作指南

1. 🏠 主交互中心 (Hub)

选择关卡：使用手柄射线指向关卡卡片，按下 扳机键 进入。

2. 🕹️ 场景一：手柄交互 (Controller Interaction)

基础移动

• 视角移动: 使用 左摇杆 自由调整视角。
• 传送: 使用 右摇杆 选择目标点并传送。

核心交互

召唤菜单: 按 菜单键	抓取物体: 按下 握持键

功能按键

A/Y键: 发射物理方块	B键: 发射粒子效果
X键: 发射交互射线	Grab键 (远程抓取): 抓取远处物体
左扳机: 发射子弹	右扳机: 体验扳机反馈
返回主中心: 指向按钮并确认

3. 🖐️ 场景二：手势交互 (Hand Tracking)

进入此场景后，请放下手柄，使用您的双手进行交互。

发射粒子: 做出特定手势	变换手部颜色: 做出特定手势
抓取物体: 做出 捏合手势	返回主中心: 做出 "V"字手势

4. 🏃 场景三：全身追踪 (Body Tracking)

进入此场景后，系统会自动识别您的身体动作并驱动一个虚拟形象。

全身驱动: 虚拟形象与真人同步	返回主中心: 使用手柄指向按钮

---

📝 注意 (Note)

• 本项目使用了用于 UE 5.4.4 的 Pico Unreal OpenXR Plugin 1.5.0 插件。如果您使用的是其他版本的虚幻引擎，则需要在此处下载并集成相应的插件版本。