常见问题
常见问题解答
只显示天空，没有 UI 或相机控制
这通常意味着启动时出现了问题。请按顺序尝试以下步骤：
- 删除
license.txt后重新启动 - 删除（先备份）
config.json— 这将重置所有设置，解决因配置文件损坏引起的问题 - 删除（先备份）内容库中的
cache.json
每次启动都崩溃，回退到旧版本也没有帮助
这通常不是 DanceXR 本身的问题，而是 VR 运行时的问题。
- 如果您安装了多个 VR 运行时，请尝试切换到其他运行时
- 对于 SteamVR：禁用不需要的启动覆盖层和插件；尝试进行干净重装
- 检查 SteamVR 的
driver文件夹中是否有最近安装或更新的内容可以移除
被要求重新激活
在进行重大操作系统或硬件更改后，DanceXR 可能无法识别该系统与您的许可证发行时相同的系统。只需再次执行激活步骤即可——不会产生额外费用。请参阅 激活与许可 指南。联系我们 如果您遇到问题。
无法启动 VR
DanceXR 使用 OpenXR 来初始化 VR。如果您安装了多个 VR 运行时，需要将其中一个设置为活动的 OpenXR 运行时：
- Oculus / Meta： 打开 Oculus 应用 → 设置 → Beta → OpenXR 运行时 → “设为活动”
- SteamVR： 打开 SteamVR → 左上角菜单 → 设置 → 开发者 → “设为 OpenXR 运行时”
- Windows Mixed Reality： 从 Microsoft Store 下载“Windows Mixed Reality OpenXR Developer Tools”，并从中将 WMR 设为活动运行时
模型加载但所有内容都是白色
最常见的原因是文件名编码——当文件名使用不同的字符编码时，贴图无法被定位。
- 对于 ZIP 包，请将编码添加到包名中，以便 DanceXR 知道如何解析文件名。在此查看详情 →
- 文件名中的额外空格也会阻止贴图加载。请在 PMXEditor 中打开模型，并确认贴图引用与实际文件名完全匹配。
头发材质是透明的
透明度深度预处理默认处于开启状态。它通过只渲染最顶层的透明层来解决透明度排序问题——这意味着堆叠的透明层（如分层的头发）只会显示最上层。
- 关闭透明度深度预处理可以渲染所有透明层。但是，如果模型材质顺序不正确，可能会引入排序伪影。
- 目前没有完美通用的解决方案——请尝试不同的配置，并使用视觉问题较少的一个。
舞台模型的天空球有孔洞或看起来像素化
这也是由透明度深度预处理引起的——当多个天空球都是透明的时，某些区域只会完整渲染最顶层。
- 关闭透明度深度预处理，或
- 找到背景天空球，并将其材质从透明更改为不透明
故障排除
查找日志文件
报告 Bug 时附上日志文件非常有帮助。日志文件记录了错误发生时的详细信息，让我们能够快速诊断问题。
日志文件位置（PC）：
C:\Users\[你的用户名]\AppData\LocalLow\VR Storm Lab\DanceXR HD
最后的文件夹名称取决于您的版本——可能是 DanceXR HD、DanceXR LW 或 DanceXR RT。
默认情况下有些文件夹是隐藏的。如果找不到 AppData，请先在资源管理器中启用隐藏文件。
打开文件夹后，请将 Player.log（当前会话）和 Player-prev.log（上一次会话）附在您的报告中。
快速修复
报告前请先尝试
请按顺序尝试以下步骤——它们可以解决大多数问题：
- 更新到最新版本 — 您的问题可能已经被修复
- 重置配置 — 备份后删除
config.json，以排除设置文件损坏的可能性 - 检查日志 — 打开
Player.log并搜索ERROR或Exception来识别问题 - VR 无法启动 — 确认您的 OpenXR 运行时已正确设置（参见上方 FAQ）
- 白色贴图 — 检查贴图引用中的文件名编码和额外空格
如果以上方法均无效，则值得提交报告。
联系我们