Unreal Hand Gameplay 项目下载及安装教程

1. 项目介绍

Unreal Hand Gameplay 是由 Oculus 示例提供的，基于虚拟现实（VR）技术中的手部追踪交互的开源项目。该项目包含了一系列可重用的组件，这些组件基于最稳健的手部追踪机制，适用于多人 VR 游戏的开发。项目提供了一种参考和模板，帮助开发者更好地实现 VR 中的手部交互体验。

2. 项目下载位置

项目托管在 GitHub 上，您可以通过以下地址进行下载：

https://github.com/oculus-samples/Unreal-HandGameplay.git

3. 项目安装环境配置（含图片示例）

3.1 安装 Git 和 Git LFS

首先，确保您的计算机上安装了 Git 和 Git LFS。Git LFS 是 Git 的一个扩展，用于处理大型文件。

在命令行中执行以下命令安装 Git LFS：

git lfs install

3.2 克隆项目

安装完 Git LFS 后，使用 Git 命令克隆项目：

git clone https://github.com/oculus-samples/Unreal-HandGameplay.git

4. 项目安装方式

4.1 使用 Epic Games Launcher

最简单的方式是使用 Epic Games Launcher 安装预构建的 Unreal Engine。请注意，Hand Movement Filtering 功能在不使用 Oculus fork 的情况下将无法正常工作。

1. 安装 Epic Games Launcher。
2. 在启动器中安装 Unreal Engine 5.3 或更高版本。
3. 打开 Unreal Editor，点击 "More"，然后点击 "Browse" 并选择 HandGameplay.uproject。

4.2 使用 Oculus Unreal fork

如果您想获得最新的 Oculus 功能集成，您需要从源代码构建编辑器。

1. 获取 Unreal 源代码。
2. 克隆 Oculus fork 的 5.3 分支。
3. 安装 Visual Studio。
4. 在 Unreal 的根目录下打开命令提示符，然后运行以下命令：

\GenerateProjectFiles.bat -Game HandGameplay -Engine <full path to Unreal-HandGameplay directory>\HandGameplay.uproject

5. 打开生成的 HandGameplay.sln 文件，将 HandGameplay 设置为启动项目，并将配置设置为 "Development Editor"。
6. 按下 F5 键构建和调试项目（和引擎）。

4.3 使用插件

要将这些功能集成到您自己的项目中，需要安装 OculusHandTools 插件。

1. 下载最新版本的 OculusHandTools.zip，并将其解压缩到项目插件文件夹中。

5. 项目处理脚本

该项目的详细实现和脚本可以在项目的 GitHub 页面上找到。您需要根据项目提供的文档和脚本进行相应的配置和处理。

以上就是 Unreal Hand Gameplay 项目的下载和安装教程。希望对您的开发有所帮助。