三維自訂模型檢查

適用場景：安裝了「FineVis資料視覺化」插件的使用者，可參考本文了解 FineVis 的相關功能。

1.1 版本

1.2 功能簡介

在上傳三維自訂模型時，使用者常因格式不符、模型過大或結構異常導致上傳失敗，且缺乏明確的錯誤提示，難以自行排查問題。

V4.0.0 版本「模型管理」內新增模型檢查功能，支援在上傳前提示模型是否符合平台要求，並指出具體問題與優化建議，如格式不支援、模型未壓縮等。

本文將以三維自訂場景組件為例，詳細介紹三維自訂模型的檢查功能。

2.1 建立組件

1）點選設計器「檔案>建立視覺化看板」，建立一張空白看板。如下圖所示：

2）點選組件區「3D>三維自訂場景」，即可將其新增到畫布中，點選「編輯組件」，進入三維自訂場景編輯頁面，生成一個空場景。如下圖所示：

2.2 上傳模型

本文提供模型資源可供使用者試用，請點選下載解壓後使用：智慧園區監視glb資源.zip

1）模型列表中未新增模型物件時，可點選「模型資源管理」或「新增模型」進入「模型管理」頁面。如下圖所示：

2）點選「上傳模型」，選擇需要的模型檔案上傳即可，支援多選模型批量上傳。如下圖所示：

注1：僅支援上傳 .glb 格式模型檔案，可透過  FineVis模型庫 下載通用模型使用，更多模型相關問題可參考 三維模型相關文檔快速引導 。

注2：glb 檔案名稱中不得包含【】中提到的字元 【 ? ! @ # $ ^ & % * + , : ; = ' \ " ` < > () [] {} / | 空格 】 。

3.1 模型符合標準

上傳單個/多個模型時，若模型符合標準，直接上傳成功，不彈出檢查彈窗。

3.2 模型可優化

上傳單個/多個模型時，若有模型可優化，彈出檢查彈窗。

支援點選「繼續上傳」，上傳後可在模型管理介面點選「查看」再次查看檢查資訊。

1）模型上傳前：在模型上傳的介面上展示產品對模型限制的提示資訊。

2）模型上傳後：點選右下角「查看」，可在模型資訊面板上展示出模型具體的檢查資訊。

3.3 模型不符合標準

若模型不符合標準，「繼續上傳」按鈕置灰，請修正模型後重新上傳。

注：多模型同時上傳時，彈出資訊彈窗：有任一可上傳模型時，可正常上傳；所有模型都為錯誤模型時，「繼續上傳」按鈕置灰。

錯誤模型可上傳至以下連結查看具體報錯資訊 ：https://sandbox.babylonjs.com/

上傳模型後，「GLTF VALIDATION」中可看見錯誤數，點選「Report Details > Open」可開啟查看具體錯誤資訊。

注：Open 中開啟的為 babylon 自帶的預設校驗邏輯結果，其中 severity 值為 0 的為具體錯誤。

4.1 功能入口

若模型可進行優化，模型檢查時或模型資訊面板上會顯示「模型待處理」以及具體優化提示。如下圖所示：

點選面板上的「跳轉到模型優化工具」按鈕，即可進入模型優化介面。如下圖所示：

在「模型優化工具」介面中點選上傳按鈕，或拖曳 glb 檔案至上傳區域，即可進行「自訂優化」操作或者「快捷優化」操作。

注：僅支援單次上傳一個檔案，建議單個檔案大小不超過 500MB 。

• 點選「自訂優化」操作直接進入模型優化介面。

• 點選「快捷優化」操作，彈出優化操作視窗，提供多種的優化方案進行選擇。

未清除瀏覽器快取時重新開啟模型優化工具頁面，若檢查到上次優化操作後的模型檔案未下載，則彈出提示框。如下圖所示：

點選確認後開啟上一次模型優化的最新操作介面，點選取消則進入到模型上傳介面。

4.2 快捷優化

點選「快捷優化」操作，彈出優化操作視窗。提供多種的優化方案，每種優化方案下方展示其優化步驟及參數。

在模型優化介面，也可在上方工具欄中點選「快捷優化」按鈕重新進入快捷優化介面。預設選中上次的優化參數，點選新的優化參數類型並確認後，在上一次的模型優化結果上再次進行模型優化操作。

注1：快捷操作的合併 mesh 差別於手動操作，快捷操作的合併 mesh 是對所有的 mesh進行一次性優化。

注2：快捷優化裏的操作為增量操作，將基於上次的優化結果進行優化。例如：首次選擇低強度優化方案將模型品質壓縮至 0.6，再次選擇後，原始模型品質總壓縮 0.36。

點選確認後進行快捷優化，點選取消後進入模型優化介面。

4.3 模型優化介面

點選「自訂優化」操作，即可進入模型優化介面。如下圖所示：

4.4 模型優化

4.4.1 合併Mesh

將無需獨立交互的部件合併為單一網格，減少 Mesh 數量以優化載入效能。

注：功能部件（如需旋轉、選中交互的部件）建議保留獨立結構，以便綁定資料。

支援自由選擇模型節點進行合併操作，點選「合併」後即可執行合併操作。無可用合併內容時，按鈕置灰。

4.4.2 刪除無用節點

刪除未包含有效資訊的空節點，優化模型檔案結構。

點選 「刪除無用節點」 按鈕，預設選中所有無用節點。支援按需手動選擇待清除的模型節點，點選「刪除」即可移除選中節點。

4.4.3 模型減面

適用於面數過多的模型，可在不影響外觀的前提下降低模型複雜度。

注1：選擇減面比例時需避免關鍵結構漸變。

注2：模型減面後可能出現原點位置偏移，導致原符合標準的原點設定失效，重新設定原點即可恢復。

點選「模型減面」按鈕，支援透過滑塊拖動（步長 0.05）或正文輸入（步長 0.01）調整倍數，取值範圍為 0-1。數字越小，減面強度越高。

注：優化操作為增量操作，將基於上次優化的模型疊加進行。

4.4.4 Draco壓縮

採用 Draco 擴展技術壓縮模型檔案體積，建議在最終匯出前使用，可顯著減小檔案大小。

點選「Draco壓縮」按鈕即可執行壓縮操作，執行成功後會提示「優化完成」。模型已執行過 Draco 壓縮時，按鈕置灰。

4.4.5 壓縮貼圖

適用於貼圖解析度過大（如 4K 貼圖）的場景，可減少記憶體佔用。支援自訂壓縮參數，需平衡畫質與效能。

點選「壓縮貼圖」按鈕，支援進行解析度壓縮和品質壓縮。

• 解析度壓縮：壓縮紋理解析度，支援選擇 1/8、1/4、1/2。

• 品質壓縮：壓縮圖片體積，支援滑塊拖動（步長 0.05）或正文輸入（步長 0.01），取值範圍為 0-1。

注：優化操作為增量操作，將基於上次優化的模型疊加進行。

4.4.6 設定原點

自訂模型原點位置，便於後續對齊、旋轉或放置操作。

注1：建議統一設定為模型底部中心或幾何中心。

注2：優化操作為增量操作，將基於上次優化的模型疊加進行。

點選「設定原點」按鈕，原點位置支援選擇頂部、中心、底部。如下圖所示：