三維資料來源

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

1.1 版本

1.2 功能介紹

三維組件資料來源可分為「資料集」資料和「WebSocket」資料：

1）資料集：支援選擇本地資料集或伺服器資料集。

2）WebSocket：透過配置 URL，可實現實時資料接入。

資料來源選擇「資料集」時，支援選擇本地資料集或系統中配置的伺服器資料集。

V4.0.0 版本支援設定重新整理頻率，進行組件內部資料重新整理。

使用 WebSocket 需購買「FVS三維組件-場景孿生」功能點，未購買時該選項灰化，提示：FVS三維組件-場景孿生未註冊，無法新增，請交握管理者註冊後重新整理增。

使用 WebSocket 需購買「FVS三維組件-場景孿生」功能點，未購買時該選項灰化，提示：FVS三維組件-場景孿生未註冊，無法新增，請交握管理者註冊後重新整理增。

透過 WebSocket 獲取資料，可以滿足資料圖層展示模型資料時標籤的高頻重新整理和實時更新需求，提升資料回應效率與使用體驗，更好地支援實時監視、動態展示等關鍵業務場景。

三維自訂組件的「資料圖層」、「模型實時運動」、「更新參數模型」和「模型資料應用事件」支援配置 WebSocket 。

注：三維城市場景和 Unity 組件圖層的資料來源暫不支援選擇 WebSocket。

3.1 資料格式要求

3.1.1 增量資料

「資料圖層」、「更新參數模型」中配置的 WebSocket 為增量資料，需明確標記資料為新增、更新或刪除。

資料格式要求為：  { id: 字串; data: { opType: "upsert"/ "delete", 其他資料鍵值對 }[]; }[]

注1：資料需要轉化為 JSON 字串。

注2：傳入資料為非陣列格式時，報錯：資料格式錯誤，要求為陣列類型，當前傳入資料為非陣列類。

資料格式具體說明如下表所示：

3.1.2 全量資料

「資料圖層-初始化」、「模型實時運動」和「模型資料應用事件」中配置的 WebSocket 為全量資料。

資料格式為：{ id: websocket配置的id; data: { 資料鍵值對; }[]; }[]

注：WebSocket 初始化時，FVS 使用者端會推播帶有 ID 的訊息，服務終止收到該訊息後視為連結建立成功，即可開始推播全量資料。

3.2 異常場景

1）使用者端初次建立 WebSocket 連結/複用連結後，會向服務端推播一條帶有 ID 的資料以標識連結建立成功。

2）WebSocket 支援連結複用，同一 URL 僅建立一個連結。

3）當多個功能複用同一 WebSocket 連結時，可透過 ID 區分各功能接收的資料，實現資料按需分發。

4）配置了全量初始化場景功能時，增量資料處理規則如下：

• 接收到初始化資料前的增量資料丟棄

• 場景載入完成前、接收到初始化資料後的增量資料正常執行更新

5）當 WebSocket 連結異常斷開時，系統支援自動重連機制，最多可嘗試重連 5 次。

• 若連結關閉時未攜帶狀態碼 1000，則視為異常斷連，系統將觸發自動重連並匯出報錯。

• 若連結關閉時攜帶狀態碼 1000，則視為正常關閉連結，系統不再進行重連。