常见问题
常见问题解答
只显示天空，没有 UI 或相机控制
这通常意味着启动时出现了问题。请按顺序尝试以下步骤：
- 删除
license.txt后重新启动 - 备份并删除
config.json— 这将重置所有设置，解决因配置文件损坏引起的问题 - 备份并删除内容库中的
cache.json
每次启动都崩溃，回退到旧版本也没有帮助
这通常不是 DanceXR 本身的问题，而是 VR 运行时的问题。
- 如果安装了多个 VR 运行时，请尝试切换到其他运行时
- 对于 SteamVR：禁用不需要的启动覆盖层和插件；尝试重新安装
- 检查 SteamVR 的
driver文件夹中是否有最近安装或更新的内容可以移除
被要求重新激活
OS 更新、硬件升级或其他系统变更后，设备 ID 可能会改变。只需重新执行激活步骤即可解决。如有问题请联系我们。
无法启动 VR
DanceXR 使用 OpenXR 初始化 VR。如果系统安装了多个 VR 运行时，需要将其中一个设置为活跃的 OpenXR 运行时：
- Oculus / Meta： 打开 Oculus 应用 → 设置 → 测试功能 → OpenXR 运行时 → “将 Oculus 设为活跃”
- SteamVR： 打开 SteamVR → 左上角菜单 → 设置 → 开发者 → “将 SteamVR 设置为 OpenXR 运行时”
- Windows Mixed Reality： 在微软商店下载 WMR OpenXR 开发者工具，从中将 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）
- 白色贴图 — 检查贴图引用中的文件名编码和多余空格
如果以上方法都无效，则值得提交报告。
联系我们