支援

在Windows上，開啟系統選單（齒輪圖示），選擇內容庫 → 在資源管理器中顯示，即可開啟內容庫資料夾。

Android和Meta Quest的共享內容庫通常位於 /DanceXR/。舊版本或使用應用內部儲存時，路徑為 /Android/data/com.vrstormlab.dancexr/files/。在iPhone或iPad上，開啟“檔案”應用，在我的iPhone或我的iPad下找到DanceXR資料夾。

將模型及其貼圖複製到內容庫的 actors/ 中，保留原有的資料夾結構。也可以將每個模型及其資源打包成單獨的ZIP檔案。

開啟角色選單，選擇載入模型，再選擇所需模型。在桌面版中，也可以將模型檔案或模型ZIP直接拖到DanceXR視窗中。

支援PMX和XPS。FBX模型載入目前是預覽功能，不會載入FBX內嵌的動畫。

將VMD或BVH動作檔案及音訊放入內容庫的 motion/ 中。舞蹈套裝可以使用WAV或OGG音訊。

開啟音訊／動作選單，選擇載入音訊／動作。桌面版也支援將檔案直接拖到DanceXR視窗中。

要讓音樂和動作一起載入，將一首歌及其相關動作放在同一個子資料夾或ZIP中。如果只有一組動作和音訊，也可以使用相同的檔名，例如 dance.vmd 和 dance.ogg。

開啟系統 → 內容庫 → 重新整理內容，等待掃描完成。在DanceXR執行時複製或移動檔案後，可以使用此功能。

應用啟動時也會檢查內容庫的變化。如果檔案仍未出現，請確認放入了正確的子資料夾：模型放在 actors/，動作和音訊放在 motion/，舞臺放在 stages/，天空貼圖放在 texture/sky/。

Native是擁有獨立算繪和設定的Windows應用程式。HD、LW和RT是Unity版本。從2026.10起，Native可在支援DirectX 12但不支援光線追蹤的電腦上使用光柵算繪；路徑追蹤需要相容的光追GPU。

Launcher負責安裝、更新和啟動執行程式與配套應用，也可以直接下載Native。請在下載頁面核對目前版本、啟用方式和功能限制。

Unity應用程式支援PMX/XPS模型、僅模型匯入的FBX預覽支援、VMD/BVH動作和OBJ場景道具。XPS/FBX模型可能需要骨骼映射。Native目前文件列出PMX/XPS模型和VMD動作。

VRM、VRChat或DAZ專案不一定是可直接使用的模型包。匯出或轉換屬於獨立流程，請確認目標格式和骨骼。DanceXR播放匯入的動作並提供程序化擺姿，不能替代完整的動畫製作工具。

在桌面Unity版本中，將完整內容庫複製到新位置並保留備份。開啟 System → Content Library → Switch Library，選擇包含各內容子資料夾的根資料夾。需要瀏覽時使用 Select Library Folder。

切換只改變DanceXR使用的位置，不會自動移動檔案。等待掃描並檢查已儲存的場景。測試舊組建時，請使用獨立設定。行動版和獨立頭戴裝置不提供此桌面資料夾選擇器。

先啟動一次DanceXR。在檔案 → 我的iPhone / 我的iPad → DanceXR中，開啟應用程式建立的內容庫（通常是 content 資料夾）。模型和貼圖放入 actors，動作和音訊放入 motion。保留原始貼圖目錄結構，也可使用完整模型ZIP。

將雲端下載複製到本機內容庫；單獨連結不等於匯入模型。使用 System → Content Library → Refresh Content 或重新啟動應用。舊版本請以應用建立的目錄結構為準。

開啟角色 → 載入模型，點選要新增的模型旁邊的 + 圖示。直接選擇模型通常會替換當前選取的角色；使用+可以保留當前角色並新增另一個。

多角色場景需要已啟用的付費版本。如果無法使用+，請檢查版本和啟用狀態。

拖動角色腳下的黃色選擇圓盤即可移動角色。拖動時使用滑鼠滾輪可以旋轉；在VR中，將控制器搖桿向左或向右撥動。

要精確調整，開啟角色的縮放與偏移設定。使用模型縮放調整大小、旋轉調整朝向、偏移X/Z調整水平位置、地面偏移調整高度。如果希望保留模型的原始大小，請關閉統一身高。

將替代貼圖放在模型資料夾內單獨的子資料夾中，或同一個模型ZIP內的任意位置。每張替代貼圖必須與被替換的貼圖使用相同的檔名。

例如，模型使用 base.png，可以在 alternate/ 子資料夾中放入另一張 base.png。重新載入模型，在角色選單的替代貼圖中選擇DanceXR檢測到的貼圖組。請將替代檔案保留在模型包內，以便掃描時找到它們。

將道具模型和貼圖放入內容庫的 accessory/，必要時重新整理內容庫。

選取的角色，開啟配件。啟用左手或右手，然後在模型中選擇道具。調整大小與對齊、旋轉和偏移，使其貼合手部。如果提供抓握姿勢選項，還可以調整握持方式。

需要使用支援配件功能的版本。

播放音訊時，啟用Playback Options中的 Lip Sync 和角色Facial Control中的 Use Lip Sync。確認音訊正在播放，並手動測試各母音控制。若手動也無效，請檢查面部映射與模型已有的骨骼或變形。

手動調整嘴型時關閉 Use Lip Sync。載入的動作和Lifelike Motions也可能修改表情。AI聊天語音使用獨立的口型驅動。

在角色的 Dressing 中控制PMX材質變形或XPS可選部件。必要時在 Material List 中檢查個別材質，不要直接隱藏整個材質群組。

如果模型本身沒有衣服下面的身體幾何體，隱藏衣服不會產生身體。有些服裝與身體共用材質。可用的換裝選項取決於模型作者的製作方式。

Eye Contact會在攝影機、其他角色和身體部位之間轉移注意。調整 Look At Camera、Look At Peers 和 Look At Body 的優先順序。Stare Mode 會持續關注最近的有效目標，替代自然的視線切換。

模型需要相容的眼部骨骼。沒有眼球骨骼時，可設定 Shape Morph Eye Control。Stare Mode不保證總是選擇觀看者。

開啟所選材質的 Textures 設定，檢查偵測到的貼圖。識別錯誤時，修正貼圖用途和通道映射。模型原始法線貼圖與平鋪細節貼圖不同。

自動關聯取決於模型格式和匯入器，改檔名並非通用修復。檢查完整模型包和原始參照路徑。仍然無效時，請提供模型格式、貼圖檔名、組建版本和截圖。

在Unity版本中調整 Application Settings → Use Translated Names。需要與模型說明或編輯器中的原始名稱對應時，將它關閉。已有標籤未更新時，重新載入模型。

作者自訂的名稱可能沒有完整翻譯。此設定只改變顯示名稱，不修改模型原始檔案或骨骼。

在Unity版本中，對模型自帶的PMX變形啟用 Override Value，再調整数值。覆寫關閉時，仍由正常動作驅動的值控制。需要已解鎖該功能的版本。

面部表情還應檢查口型同步、載入的動作和Lifelike Motions，它們可能驅動同一個表情。其他模型格式和Native不一定使用相同控制。

先確認角色的物理方式。PMX自帶剛體和關節可比較 Physics Mode 選項；Auto 使用系統 PMX Default。XPS/FBX自訂工具中，啟用 Hair Physics 或 Skirt Physics，用 Select Bones 選擇骨骼鏈根部，並檢查身體碰撞體。

一次只調一個設定：PhysX用彈簧和阻尼，XPBD用柔順度和阻尼。用自訂工具替換PMX物理時，先將PMX Physics Mode 設為 Off。功能可用性隨組建和版本而異，Native有獨立物理設定。

在音訊／動作選單中載入動作，然後選取要播放動作的角色。

選擇動作並使用指派給選取的角色。也可以開啟角色選單，從動作列表中選擇已載入的動作。要讓所有角色執行同一個動作，請使用指派給所有角色。

如果XPS或FBX角色仍停留在標準姿勢，請檢查其骨骼對映器中的指派。

載入群舞套裝，使所有動作軌道都可用。在動作選單中使用指派所有角色，將不同軌道指派給場景中已有的角色。

如果希望DanceXR自動載入角色併為每個角色指派軌道，使用載入並指派角色。要手動控制，逐個選取的角色，對所需軌道使用指派給選取的角色。

多角色場景需要已啟用的付費版本。

在 motion/ 下建立子資料夾或ZIP，將歌曲、角色動作檔案和鏡頭動作放入其中。每個包中只保留一個音訊檔案。DanceXR會把相關檔案識別為舞蹈套裝，方便一起載入。

對於一組動作和音訊，相同的檔名（例如 dance.vmd 和 dance.ogg）也可以。如果同一資料夾內包含無關檔案，請將它們分成獨立的包，明確分組關係。

載入模型，在角色選單中開啟骨骼對映器。執行自動對映，檢查帶感嘆號的槽位：這些是尚未指派、但正常動作所必需的骨骼。

將每個缺失槽位對映到模型中對應的骨骼。鏈式對映可以加快手臂、手指等骨骼鏈的設定。完成必要對映後，指派動作並檢查結果。

XPS和FBX需要骨骼對映。PMX模型通常已包含標準骨骼名稱。

先用預設設定比較同一個模型和動作，再一次調整一個控制項。檢查 Feet On Floor、Ground Offset 和 Reduce Sliding。錯誤的骨骼映射或標準姿勢也會影響結果。

Unity版本中，請檢查 Motion Leg IK 與 Model IK 是否產生衝突。不要把關閉全部IK當作通用修復。如果新版本破壞了原本正常的模型，請報告模型、動作、目前版本和最後正常的組建版本。

檢查整體播放速度和動作自身的速度設定。非標準來源幀率可能需要單獨調節動作速度，不要把所有動作都設為兩倍速。錄製FPS是另一項設定。

音樂對齊時檢查音軌的音訊偏移；程序化舞蹈則檢查 Music Timing 中的BPM和節拍偏移。一次改一個設定，並與預期播放效果比較。

從程序化動作清單選擇 Free Pose，將目前動作替換為手動擺姿。拖動身體控制柄；滑鼠使用者可用滾輪調整深度，VR使用者可用射線拖動或直接握住控制柄。

先讓雙腳著地。拖動腳後保持不動，標記變綠即可固定；紅色時放開會回落。Reset 解除固定並恢復自然站姿。不要把暫時固定理解為已儲存的可重用姿勢。

將全景天空圖片放入內容庫的 texture/sky/。環境貼圖推薦使用HDR格式。如果在DanceXR執行時新增了檔案，請使用系統 → 內容庫 → 重新整理內容。

開啟環境 → 天空，將模式設為天空貼圖，再在天空貼圖中選擇圖片。要旋轉背景，請調整方向。

開啟環境 → 天空，確認模式為天空貼圖。調整方向，即可讓全景背景繞場景旋轉。

這也會旋轉地面天空穹頂材質所使用的天空投影，因此修改後請檢查地面和反射效果。

開啟環境 → 天空。

在HD/RT版本中，背景控制可見天空的亮度，天空環境光控制天空對場景照明的影響。如果明亮背景使角色的明暗層次變淡，請降低天空環境光。

輕量版使用天空曝光度和強度。天空曝光度也會影響反射亮度，調整時請同時檢查反光材質。

將舞臺模型和所需貼圖放入內容庫的 stages/，保留原有資料夾結構，或將整套資源打包成ZIP。標記為 stage 的角色模型也可以顯示在舞臺選單中。

必要時重新整理內容庫，然後開啟場景 → 載入舞臺並選擇模型。載入新舞臺會替換舊舞臺。使用已載入舞臺的設定調整外觀和位置。

舞臺和道具模型不能播放動作。要讓它們播放動作，請將檔案放入 actors/，作為角色載入，再指派動作。天空貼圖是另一類資源，應放在 texture/sky/。

點選空白處，在介面、控制和沉浸模式之間切換。沉浸模式會隱藏選單和黃色的角色選擇圓盤，讓畫面保持整潔。

也可以使用已繫結的切換介面操作，桌面版預設按鍵為 Esc。再次點選空白處或使用切換介面，即可恢復顯示。

將鏡頭VMD與歌曲、角色動作放在同一個舞蹈套裝資料夾或ZIP中，然後載入該套裝。

開啟相機，選擇已載入套裝中的鏡頭動作。Freefly、Auto等內建相機模式是其他選項；要跟隨舞蹈作者設計的鏡頭運動，請選擇匯入的軌道。

軌道缺少時，請檢查載入的包中是否有該檔案。Unity VR版本結合頭部追蹤與攝影機整體移動，具體行為取決於所選相機模式。Freeze in VR 會在UI可見時暫停移動。Native有獨立攝影機控制。

使用 Creator Edition 進行離線渲染。開啟錄製選單（紅色圓圈），進入錄製設定，選擇 UHD 3840x2160、所需影格率和圖片格式。

先預覽場景，檢查構圖和動作，再開始 2D 錄製。即使即時播放達不到所選影格率，DanceXR仍會按目標輸出影格率渲染每一幀。

輸出為圖片序列，需要在渲染完成後轉換為影片。具體步驟請參閱圖片序列轉影片的回答。

開啟渲染幀所在的資料夾。如果已安裝FFmpeg，並且可以透過系統PATH執行它，可以使用錄製附帶的轉換批次處理檔案。也可以使用支援匯入圖片序列的影片編輯軟體。

手動轉換示例：假設以60 fps錄製，檔名為 movie_0000.jpg、movie_0001.jpg 等。

ffmpeg -framerate 60 -i movie_%04d.jpg -i sound.wav movie.mp4

請將影格率、編號格式和副檔名改為實際輸出所使用的值。不需要音訊時，省略 -i sound.wav。

使用螢幕錄製軟體，即時錄下DanceXR的播放畫面即可，不需要Creator Edition。

1. 開啟系統 → 顯示與介面 → 解析度，關閉全螢幕，使用視窗模式。
2. 選擇視窗解析度。直向時開啟垂直，橫向時關閉。
3. 點選套用解析度，調整構圖；如需乾淨畫面，可以隱藏介面。
4. 在螢幕錄製軟體中選擇DanceXR視窗及其音訊，開始錄製後播放動作。

錄製流暢度取決於實際播放影格率。如果播放卡頓，請降低畫質設定或解析度。

使用已啟用的 Creator Edition。在錄製選單中選擇 Record 3D → Side by Side / Top Bottom，或 Record VR → VR 120 3D / VR 180 3D / VR 360 2D。VR360是單眼。先檢查 Preview 和Recording Settings。

錄製會產生影像序列。用影片編輯器或產生的批次檔轉換；批次檔需要FFmpeg。全景批次檔使用NVIDIA編碼器，其他GPU需改用可用編碼器。在VR播放器中選擇相符的投影和立體模式。

設定好角色、舞臺、動作、環境和相機後，開啟場景，使用已儲存場景瀏覽器中的儲存圖示。輸入名稱並選擇儲存。

要恢復配置，返回場景瀏覽器，選擇儲存的名稱。場景儲存的是設定及對資源的引用，請將原始模型和動作保留在內容庫中。如果還需要傳輸資原始檔，請使用場景包。

使用場景包，將場景與模型、舞臺、道具、配件和舞蹈套裝一起打包。

載入並檢查場景，開啟場景 → 場景包，使用儲存操作輸入名稱。等待正在建立場景包…結束後，將壓縮包複製到目的裝置內容庫的 bundles/ 中並開啟。

在目的裝置上檢查播放和材質。可用功能仍取決於目的裝置的構建版本和版本等級。場景包選單需要已啟用的付費版本。

配置好角色，開啟其預設選單。選擇儲存角色預設，將設定與該模型關聯；選擇儲存為全域性預設，則可供其他角色使用。輸入名稱並儲存。

使用時，選取的角色，在預設選單中選擇已儲存的條目。預設僅儲存設定，不包含模型檔案。應用到其他模型時，請檢查骨骼對映、材質槽位和物理設定，因為它們可能不同。

調整燈光、天空、地面等應用設定，然後開啟環境 → 系統預設。使用儲存操作，輸入名稱並選擇儲存。

以後從同一選單中選擇已儲存的預設即可應用。設定儲存在內容庫的 presets/system/ 中。如果還要恢復角色、已載入資源及動作指派，請儲存場景。

在PC上，連線頭戴裝置並啟動VR軟體。確認正在使用的執行時（如SteamVR或Meta）已被設定為當前 OpenXR 執行時。

啟動支援VR的DanceXR構建版本，開啟環境並開啟 VR。使用獨立Quest時，從頭戴裝置中啟動已安裝的Quest版本。

如果VR未啟動，請檢查當前執行時，並參閱VR啟動故障排查的回答。

授予DanceXR使用共享 /DanceXR/ 資料夾所需的儲存許可權。模型放入 actors/，動作和音訊放入 motion/，其他資源放入對應的內容庫子資料夾。

可以使用裝置上的“檔案”應用，或透過USB連線PC並選擇檔案傳輸。Android的內容管理器應用也能將支援的ZIP和圖片檔案新增到內容庫。

舊版本或內部儲存模式使用 /Android/data/com.vrstormlab.dancexr/files/。複製後重新啟動DanceXR，或執行重新整理內容。

在支援的Android或iOS裝置上啟動DanceXR，開啟環境，選擇 AR。如果裝置請求相機許可權，請允許訪問，然後等待AR初始化。

在AR設定中使用顯示相機來顯示真實環境背景。若希望角色看起來直接站在實際地板上，啟用隱藏地面。使用停止AR返回普通模式。

AR需要已啟用的Pro版本及相容的裝置／構建版本。如果沒有AR選項，請同時檢查裝置支援情況和啟用狀態。Quest穿透顯示功能另有說明。

Unity版本中，Freeze in VR 會在選單可見時暫停攝影機移動。隱藏選單再試，或在Camera Settings中調整 Freeze in VR，允許操作選單時移動。

頭部追蹤與攝影機整體移動不同。如果隱藏選單後控制器仍無法移動，請提供組建版本、頭戴裝置、控制器和OpenXR執行環境。Native使用獨立控制系統。

在Unity版本中檢查 Controller Input → Options。關閉 Trackpad Mode，嘗試不按下觸控板或搖桿的軸輸入。握持誤觸時，可提高 Grip Threshold 或關閉 Use Grip Input；後者也會停用握持互動。

一次只改一個選項。這些是可嘗試的設定，不保證適用於所有頭戴裝置。Native的控制設定獨立。

在Unity VR版本中指向選單面板，按住控制器 grip button 並移動手來重新定位，放開後留在該位置。

在 Environment → VR → UI 調整 UI Distance 和 UI Auto Return。Auto Return讓移出視野的面板返回。選單隱藏時，用已綁定的Toggle UI重新顯示。Native使用獨立介面。

模型全白通常表示無法找到貼圖檔案。請保持貼圖相對於模型檔案的原始位置。

如果ZIP內包含日文或中文檔名，可以新增對應編碼字尾：日文使用 model.jis932.zip，中文使用 model.gb2312.zip。重新命名壓縮包後重新載入模型。Android的內容管理器也可以設定此編碼。

如果仍然全白，請檢查模型的貼圖引用，確認檔名、資料夾路徑和空格與實際檔案完全一致。

在HD/RT版本中，透明深度預處理可能使多層透明頭髮的內層消失。

嘗試關閉系統 → 圖形 → 選項 → 透明預處理並比較結果。若希望只修改區域性，可以僅調整受影響的頭髮材質的透明預處理。

關閉後可能出現其他透明排序問題。請從多個角度檢查，選擇最適合該模型的設定。

絲襪、睫毛或衣服不透明或消失時，還需檢查材質 Auto / Opaque / Transparent 分類、可見性及群組/全域覆寫。缺少貼圖與透明層問題不同。上述預處理建議適用於HD/RT，Native和其他算繪管線使用不同控制。

確認VR軟體正在執行，頭戴裝置所用的執行時已設為當前 OpenXR 執行時。如果安裝了多個執行時，請在所選執行時的設定中將其啟用，再重新啟動該執行時和DanceXR。

再次嘗試開啟環境 → VR。如果仍然失敗，請禁用不必要的VR疊加層或外掛，並檢視DanceXR的 Player.log 中的錯誤。報告問題時，請附上日誌、應用構建版本、頭戴裝置和執行時資訊。

Steam和Google Play版本通常會在商店驗證購買後自動啟用。

需要手動啟用的版本，請開啟系統 → 啟用您的副本。按照瀏覽器提示，選擇購買平臺並登入。成功頁面出現後，返回DanceXR，再次點選啟用您的副本以獲取授權。

如果該裝置之前已啟用，DanceXR可能無需開啟瀏覽器即可還原授權。重新安裝、更換硬體或切換構建版本後再次啟用，不會額外收費。

PC、Android和iOS不一定同時更新。Steam預設分支和測試分支可能使用不同組建；Patreon提前發布不代表所有商店版本都已獲得相同功能。

請檢查目前更新說明、下載頁面的版本資訊和啟用狀態。詢問缺少功能時，請提供平台、購買版本、執行程式、完整版本號及Steam分支（如適用）。行動版有獨立發布安排，PC發布日期並非行動版的交付承諾。

用預設場景和單個角色與問題場景比較。降低算繪比例，並逐項測試鏡面、陰影和高負載效果。Unity HD/RT有畫質預設；Native提供 Detect best settings、光柵畫質檔位及獨立的桌面/VR圖形設定。

路徑追蹤雜訊與卡頓不同：Native的Realtime使用降噪和升頻，Reference為靜態畫面累積採樣。問題持續時，請提供裝置/GPU、組建版本、場景、FPS和記錄檔。不要假設一個設定能修復所有平台。

同樣是由半透明深度預處理引起的 —— 當存在多個半透明天空球時，在某些區域只會完全渲染最頂層。

• 關閉半透明深度預處理，或者
• 找到背景天空球，並將其材質從半透明更改為不透明。

1. 更新至最新版本 —— 您的問題可能已在新版本中得到解決。
2. 重置設定 —— 備份並刪除 config.json 以排除設定檔損壞的情況。
3. 重置授權/許可證 —— 如果應用程式無法啟動或行為異常，請嘗試從安裝目錄中刪除 license.txt 並重新啟動。
4. 清除媒體庫快取 —— 備份並刪除內容庫資料夾中的 cache.json，以強制播放器重新掃描您的檔案。
5. OpenXR 設定 —— 如果 VR 無法啟動，請仔細檢查您的 VR 軟體設定中是否正確設定了當前活動の OpenXR 執行階段。

報告 bug 時，附上記錄檔會非常有幫助。請在您的 bug 報告中附帶 Player.log（目前工作階段）和 Player-prev.log（上一次工作階段）。

Windows PC 路徑：

C:\Users\[User]\AppData\LocalLow\VR Storm Lab\DanceXR [HD|LW|RT]\Player.log

注意：請將 [User] 替換為您的 Windows 使用者名稱。如果 AppData 資料夾被隱藏，請在 Windows 檔案總管中啟用「隱藏的項目」。

Android 和 Meta Quest 路徑：

/Android/data/com.vrstormlab.dancexr/files/Player.log

注意：透過 USB 將您的裝置連接到電腦，並使用檔案傳輸模式來定位此檔案。

Native 請使用 System → Open Log、Copy Diagnostics 或 Report Issue，不要套用Unity記錄檔路徑。報告中包含完整組建版本、平台、算繪器/VR執行環境、重現步驟、預期結果和截圖。僅分享有權提供的模型或動作。行動版儲存存取隨系統版本變化，USB不一定顯示所有應用資料夾。

這通常意指在啟動過程中出了問題。請按順序嘗試以下步驟：

• 刪除 license.txt 並重新啟動。
• 刪除（請先備份）config.json —— 這將重置所有設定並修復由於設定檔損壞引起的問題。
• 從您的內容媒體庫中刪除（請先備份）cache.json。

這通常是 VR 執行階段的問題，而不是 DanceXR 本身的問題。

• 如果您安裝了多個 VR 執行階段，請嘗試切換到另一個。
• 對於 SteamVR：停用不需要的啟動重疊層（overlays）和外掛程式；嘗試乾淨的重新安裝。
• 檢查 SteamVR 的 driver 資料夾，看看是否有最近安裝或更新的可以刪除的項目。

這是由動作平滑系統中的 bug 引起的。臨時解決方法：在動作設定中停用動作平滑。

這是由於模型定義的 IK 在動作沒有 IK 移動時處於啟用狀態。解決方法：在演員動作設定中停用「模型 IK」。 注意：在 2026.7 版本發布後，這不再需要。