SteamVR 项目运行时不显示手柄控制器的问题

Mon, 17 Feb 2025 17:15:00 +0800

问题现象

在开发 SteamVR 项目时，很多开发者会遇到 VR 项目在运行时不显示手柄控制器的问题。

原因分析

出现该问题的主要原因，多数是因为 VR 项目路径存在于中文路径下（包括项目名称）所致。

自 SteamVR 2.0 发布以来，SteamVR SDK 所需的手柄控制器模型不再包含在开发包内，而是在 SteamVR 客户端的安装目录下，具体路径为（以 HTC VIVE 为例）：

(Steam安装目录)\steamapps\common\SteamVR\resources\rendermodels\vr_controller_vive_1_5

在此文件夹下，可以看到包含了多种文件，包括 obj 模型、mtl 材质、png 贴图和一个名称为 vr_controller_vive_1_5.json 的文件。其中，json 文件负责记录手柄控制器的各个部件信息，通过它提供的信息，可以将各个部件组织为一个完整的手柄控制器，以下为该文件部分内容：

"trigger": {
 "filename": "trigger.obj",
 "motion": {
 "type": "rotate",
 "controller_axis": 1,
 "controller_axis_component": 0,
 "trigger_path": "/input/trigger",
 "value_mapping": [0.0, -17.0],
 "pivot": [0.0000, -0.016, 0.039],
 "axis": [1.0, 0.0, 0.0]
 },
 "component_local": {
 "origin": [0.0, -0.039, 0.051],
 "rotate_xyz": [-83.885, 0.0, 0.0]
 }
}

当程序运行时，会按照路径先找到 json 文件，然后基于 json 文件提供的信息找到这些部件。

当路径中存在中文时，系统可能因编码问题生成乱码路径，导致 json 文件解析失败，模型部件引用路径生成乱码（如 vr_controller_vive_1_5_æ§å¶å¨.obj），最终导致手柄控制器不能顺利加载呈现。同时可能伴随如下错误日志：

为什么不再推荐使用 VRTK 4？

Fri, 28 Jun 2024 15:48:00 +0800

引言

VRTK（Virtual Reality Toolkit）发布于 2016 年，初期受到了广大开发者的欢迎并被广泛采用。但是随着 VR 开发生态的发展，这款工具逐渐失去了最初的光芒。本文试图通过几个维度的分析，解释为什么目前不推荐使用 VRTK 进行开发的理由，希望能够为正在选择 VR 开发工具的开发者们提供一些参考和启示。

VRTK 的初期成功与高光时刻

VRTK 最初作为一款名为 SteamVR Unity Toolkit 的开发工具发布，在 Valve 的 SteamVR SDK（1.x）基础上集成了一些便利的交互功能，以弥补当时 SteamVR SDK 功能相对匮乏的不足。在 3.0 版本发布后，VRTK 迎来了高光时刻，一直持续到 SteamVR 2.0 发布。VRTK 3.x 让 VR 开发变得更加高效和便利，开发者只需对相关组件进行简单配置，即可实现丰富的交互功能，这使其在 VR 行业起步阶段受到广大开发者的欢迎。也正是由于其便利性给开发者留下了深刻的印象，所以大家才会对随后的 VRTK 4 充满了期待。

然而随着 VR 开发生态的不断发展，以及 VRTK 开发团队自身的一些原因，VRTK 目前已不再是开发者的首选开发工具。

外部环境的变化

VRTK 发布之初，VR 行业还处于起步阶段，彼时主流 VR 平台主要是运行在 SteamVR 之上的 HTC VIVE 和 Oculus Rift，移动 VR 平台尚未兴起，更谈不上开发工具。很多目前开发者熟知的 VR 开发工具尚未发布，比如 MRTK、Interaction Toolkit、UltimateXR 以及收费的 Auto Hand、VR Interaction Framework 等。在这种环境下，多数开发者（至少是国内开发者）倾向于选择 VRTK 来开发 VR 项目。可以说，VRTK 的流行也是吃到了一波时代的红利。