內容庫

內容庫是一個文件夾，DanceXR用來定位內容並存儲用戶創建的設置。

定位內容庫

Windows：在Windows上，您可以通過在系統菜單中（左下角的齒輪圖標）的“內容庫”部分中點擊“在資源管理器中顯示”項目來定位內容庫。

Android：在2024.3更新之後，內容文件夾位於您的存儲空間中的/DanceXR/。如果您使用的是舊版本，則位於/Android/data/com.vrstormlab.dancexr/files/。

iPhone和iPad：您可以在“我的iPhone”或“我的iPad”部分的文件應用中找到內容庫。DanceXR在設備的根目錄中創建一個名為“DanceXR”的文件夾。

Oculus Quest：在2024.3之後，內容庫位於您的存儲空間中的/DanceXR/，舊版本位於/Android/data/com.vrstormlab.dancexr/files/。與Android版本類似。

文件夾結構

DanceXR在內容庫中的不同子文件夾中搜索各種類型的內容。

演員：角色模型
運動：運動和音頻文件
舞台：舞台的3D模型
配件：可以附加到角色身體部位的3D模型。
道具：可以用於舞台道具（如家具）的3D模型。
紋理
- cookie：用於光罩的紋理
- drawing：用於身體彩繪功能的保存圖像
- ground：地面紋理
- mask：可以應用於模型的細節和法線貼圖
- particle：用於粒子效果的紋理
- sky：全景天空地圖，建議使用HDR格式
設置：所有保存的設置。這些文件不應由用戶修改，但如果您喜歡，可以進行備份。
場景：保存的場景文件。
包：保存的場景以及所有必要資源包含在壓縮包中。
導出：使用3D快照功能時可以在此處找到導出的模型文件。
預設：保存的預設文件。只要您使用相同版本的DanceXR，就可以與朋友分享這些文件。
視頻：可用於投影和動態紋理映射的視頻。僅支持MP4格式。
聊天：用於AI聊天系統的文件。
- 字符：角色縮略圖和模板。這些是自動生成的，但您可以進行修改。
- 模板：提示模板，您可以進行修改並創建新模板。
- 歷史：保存的聊天記錄
- 人物：可以應用於角色的個性描述
- 聲音/piper/：TTS系統的自定義語音模型

支持的格式

3D模型：PMX、XPS和OBJ（用於舞台道具）
音頻：OGG和MP3（僅限移動平台）
視頻：MP4
運動：VMD、BVH
紋理：PNG、JPG和HDR（用於天空地圖）

分組和組織

為了更輕鬆地管理數據文件，特別是對於那些需要多個文件一起工作的內容，我們支持使用壓縮包來組織您的文件。您也可以將所有所需文件放在子文件夾中，它們應該可以正常工作。

3D模型

3D模型通常帶有一個描述網格的文件和多個紋理文件。確保在移動或提取文件時，紋理和網格文件之間的相對關係保持不變是很重要的，這對於程序找到正確的紋理使用是很重要的。

對於PMX，網格文件是.pmx文件，對於XPS，網格文件可以是.xps、.mesh或.mesh.ascii。

建議將一個模型的所有文件放在一個壓縮包中，以獲得更小的文件大小和更輕鬆的管理。

一些模型具有替代紋理。DanceXR可以搜索文件夾或壓縮包，找到與模型使用的紋理類似的紋理文件，並自動將它們包含在菜單中供您選擇。為了使這個功能正常工作，您需要確保替代紋理與主紋理具有相同的文件名。例如，如果基本貼圖命名為base.png，當DanceXR在不同子文件夾中找到另一個base.png時，它將自動將其添加為替代紋理。如果您的模型在壓縮包中，DanceXR將搜索整個壓縮包以尋找替代紋理。如果您的模型在子文件夾中，它將從網格文件所在的所有子文件夾中搜索。請記住這一點，因為如果您將替代紋理放在網格文件文件夾之外，它們將無法被識別。

演員文件夾示例