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），最终导致手柄控制器不能顺利加载呈现。同时可能伴随如下错误日志：

HTC VIVE on XR技术研习社

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

问题现象

原因分析