常見問題
常見問題解答
只顯示天空，沒有 UI 或相機控制
這通常表示啟動時發生了問題。請依序嘗試以下步驟：
- 刪除
license.txt後重新啟動 - 備份並刪除
config.json— 這將重置所有設定，解決因設定檔損壞引起的問題 - 備份並刪除內容庫中的
cache.json
每次啟動都當機，回到舊版本也沒有改善
這通常不是 DanceXR 本身的問題，而是 VR 執行環境的問題。
- 若安裝了多個 VR 執行環境，請嘗試切換到其他環境
- 對於 SteamVR：停用不需要的啟動覆疊和附加元件；嘗試重新安裝
- 檢查 SteamVR 的
driver資料夾中是否有最近安裝或更新的內容可以移除
被要求重新啟用
OS 更新、硬體升級或其他系統變更後，裝置 ID 可能會改變。只需重新執行啟用步驟即可解決。如有問題請聯絡我們。
無法啟動 VR
DanceXR 使用 OpenXR 初始化 VR。若系統安裝了多個 VR 執行環境，需要將其中一個設為作用中的 OpenXR 執行環境：
- Oculus / Meta： 開啟 Oculus 應用程式 → 設定 → Beta → OpenXR 執行環境 → 「將 Oculus 設為作用中」
- SteamVR： 開啟 SteamVR → 左上角選單 → 設定 → 開發者 → 「將 SteamVR 設為 OpenXR 執行環境」
- Windows Mixed Reality： 在 Microsoft Store 下載 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）
- 白色材質貼圖 — 檢查材質貼圖參照中的檔案名稱編碼和多餘空格
若以上方法都無效，則值得提交回報。
聯絡我們