支持中心
我们能为您提供什么帮助？
快速修复
报告前请先尝试
在提交 Bug 报告前，请先执行以下快速故障排除步骤：
- 更新到最新版本 — 您遇到的问题可能已经在较新的版本中被修复。
- 重置配置 — 备份后删除
config.json，以排除设置文件损坏的可能性。 - 重设授权 — 如果应用程序无法启动或行为异常，请尝试从安装目录中删除
license.txt并重新启动。 - 清除缓存 — 备份并删除内容库文件夹中的
cache.json，以强制播放器重新扫描您的文件。 - OpenXR 设置 — 如果 VR 无法启动，请再次确认您的 VR 软件设置中是否正确设置了活动的 OpenXR 运行时。
故障排除
查找日志文件
报告 Bug 时附上日志文件非常有帮助。日志文件记录了错误发生时的详细信息，让我们能够快速诊断问题。
Windows PC 路径：
C:\Users\[User]\AppData\LocalLow\VR Storm Lab\DanceXR [HD|LW|RT]\Player.log
*注意：请将 [User] 替换为您的 Windows 用户名。最后一个文件夹名称取决于您的版本（例如 DanceXR HD、DanceXR LW 或 DanceXR RT）。如果找不到 AppData 文件夹，请在资源管理器中开启“隐藏的项目”。*
Android & Meta Quest 路径：
/Android/data/com.vrstormlab.dancexr/files/Player.log
*注意：请使用 USB 将您的设备连接到 PC 并选择文件传输，或使用设备上具有适当权限的文件浏览器应用程序来找到此文件。*
请将 Player.log（当前会话）和 Player-prev.log（上一次会话）附在您的 Bug 报告中。
常见问题
常见问题解答
🖥️ 系统与 VR 启动
只显示天空，没有 UI 或相机控制
这通常意味着启动时出现了问题。请按顺序尝试以下步骤：
- 删除
license.txt后重新启动。 - 删除（先备份）
config.json— 这将重置所有设置，解决因配置文件损坏引起的问题。 - 删除（先备份）内容库中的
cache.json。
每次启动都崩溃，回退到旧版本也没有帮助
这通常不是 DanceXR 本身的问题，而是 VR 运行时的问题。
- 如果您安装了多个 VR 运行时，请尝试切换到其他运行时。
- 对于 SteamVR：禁用不需要的启动覆盖层和插件；尝试进行干净重装。
- 检查 SteamVR 的
driver文件夹中是否有最近安装或更新的内容可以移除。
无法启动 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 中打开模型，并确认贴图引用与实际文件名完全匹配。
如何在 Android 或 Meta Quest 上设置内容库？
Android 系统有严格的文件访问限制。默认情况下，内容库会放置在应用程序内部存储空间中。
- 使用 USB 将您的设备连接到 PC，选择“文件传输”，然后移至
/Android/data/com.vrstormlab.dancexr/files/或根目录/DanceXR/文件夹以复制您的 zip/图片文件。 - 在 Android 和 Meta Quest（自版本 2024.3 起），授权 DanceXR 存储访问权限，以便使用系统“文件”应用程序或内置的“内容管理器”应用程序来分享与管理您的库。
- 更多详细信息，请参阅 Android 与 Quest 内容库 指南。
🎨 画面与渲染
头发材质是透明的
透明度深度预处理默认处于开启状态。它通过只渲染最顶层的透明层来解决透明度排序问题——这意味着堆叠的透明层（如分层的头发）只会显示最上层。
- 关闭透明度深度预处理可以渲染所有透明层。但是，如果模型材质顺序不正确，可能会引入排序伪影。
- 目前没有完美通用的解决方案——请尝试不同的配置，并使用视觉问题较少的一个。
舞台模型的天空球有孔洞或看起来像素化
这也是由透明度深度预处理引起的——当多个天空球都是透明的时，某些区域只会完整渲染最顶层。
- 关闭透明度深度预处理，或
- 找到背景天空球，并将其材质从透明更改为不透明。
🔑 授权与付款
联系我们