三維自訂模型檢查

適用場景：安裝了「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 的為具體錯誤。