Amfitrack用户指南

Unreal Engine 使用指南

Unreal Engine 使用指南（Unreal Engine 5.5）

本指南介绍如何在 Unreal Engine 5.5 中下载、配置并使用 AMFITRACK SteamVR Driver。

前提条件（Prerequisites）

开始之前，请确保已经安装：

  • Unreal Engine

  • AMFITRACK SteamVR Driver

Unreal Engine 配置

下面介绍如何配置 Unreal Engine、启用所需插件，并将 AMFITRACK 控制器的位姿（Pose）数据绑定到场景中的对象。

说明：

本教程已在 Unreal Engine 5.5 上完成测试。

第一步：创建 Unreal Engine 项目

打开 Unreal Engine。

创建一个新项目：

选择：

Blank Project

项目参数设置如下：

参数设置值
Project TypeGame
Programming LanguageBlueprint（蓝图）

设置完成后：

点击：

Create

创建项目。

第二步：安装所需插件

打开：

Edit
    ↓
Plugins

搜索并启用以下插件：

  • LiveLink

  • LiveLinkOpenVR

  • LiveLinkXR

启用完成后，

Unreal Engine 会提示重新启动。

点击：

Restart

重新启动 Unreal Engine。

第三步：验证 Live Link 是否正常

打开：

Window
    ↓
Virtual Production
    ↓
Live Link

打开 Live Link 窗口。

添加数据源

点击：

Add Source

选择：

LiveLinkOpenVR Source

随后：

在 Track Controllers 列表中，

选择需要跟踪的 AMFITRACK 控制器。

验证设备

正常情况下，

Live Link 中应该显示四个设备。

其中：

左右控制器分别显示为：

Controller_Amfitrack_Controller_Left
Controller_Amfitrack_Controller_Right

如果能够看到以上设备，

说明：

SteamVR 与 Unreal Engine 已成功通信。

第四步：将 Live Link 绑定到场景对象

找到 Blueprint

打开：

Project
    ↓
Engine
        ↓
Plugins
            ↓
LiveLinkXR Content
                ↓
Blueprints

找到：

BP_LiveLinkXE_DataHandler

（不同版本中名称可能略有差异，如 BP_LiveLinkXR_DataHandler。）

将其拖入（Drag & Drop）

到当前场景（Viewport）。

创建一个测试物体

例如：

创建一个：

Cube

作为测试对象。

选择 DataHandler

在：

Outliner

中，

选择：

BP_LiveLinkXE_DataHandler

第五步：绑定控制器

找到：

Subject Name to Attached Actor

点击：

+

新增一条映射。

然后：

打开：

Live Link

查看：

控制器名称。

例如：

Controller_Amfitrack_Controller_Left

把这个名称输入：

Subject Name to Attached Actor

对应字段。

然后：

右侧下拉菜单中，

选择：

刚刚创建的：

Cube

这样：

Cube 就会绑定到：

AMFITRACK 左控制器。

验证结果

配置完成后，

移动：

AMFITRACK 控制器。

如果：

Cube 随控制器同步移动，

说明：

配置成功。

即：

AMFITRACK 位姿数据已经成功驱动 Unreal Engine 场景中的对象。

故障排查（Troubleshooting）

找不到插件

如果：

LiveLink

LiveLinkOpenVR

LiveLinkXR

没有出现：

请检查：

  • 是否安装了对应插件；

  • 是否启用了插件；

  • 是否在启用后重新启动了 Unreal Engine。

Live Link 中没有设备

如果：

Live Link 没有检测到 AMFITRACK 控制器，

请检查：

  • AMFITRACK SteamVR Driver 是否正确安装；

  • SteamVR 是否已经启动；

  • AMFITRACK 硬件是否正常连接并开机。

附加说明（Additional Notes）

  • 本教程适用于 Unreal Engine 5.5。

  • 如果使用较早版本的 Unreal Engine，部分菜单名称或界面可能会有所不同。

  • 更多详细内容请参考 Unreal Engine 官方文档。