三維場景參數模型

1.1 版本

1.2 應用場景

在三維場景中，有時需要三維場景內的模型能夠結合資料即時反饋現實場景內對應實體的數量變化，該需求可透過參數模型實現。普通模型為三維場景內匯入的模型，而參數模型是由資料驅動動態變化的模型。結合參數模型與「更新參數模型」事件，可實現在三維場景內實時生成某種三維模型，例如新增倉庫 AGV 小車、運輸軌道貨箱等業務場景。

1.3 注意事項

• 為保證流暢渲染，建議整個場景中的總網格數控制在 3000 以內（單個模型的網格數 × 資料條數 = 參數模型總網格數） 。

• 支援使用經緯度座標、三維空間座標或父實體座標的點位座標資料，適配真實地理映射、室內空間定位或相對參照定位的不同場景需求。

• 支援使用資料集或 WebSocket 的資料源，滿足標準業務與秒級實時資料需求。

• 資料圖層支援匹配參數模型生成的模型名稱，匹配方式與普通模型保持一致。

• 參數模型支援設定顯示隱藏。

• 參數模型不支援的效果：反射、模型動畫及動畫方案、線框風格、公共視角綁定、JS API。

2.1 參數模型

參數模型是指三維場景內能透過資料進行變化的模型。

1）進入三維自訂場景組件編輯介面，在模型列表中選中模型，右鍵根節點模型，點選「轉為參數模型」，可將普通模型轉換成參數模型。如下圖所示：

2）點選「轉為參數模型」後，需進行資料來源、模型名稱、模型位置設定。

具體說明如下表所示：

3）「模型資料設定」配置完成後，傳回模型列表，模型已轉換為參數模型。

• 模型列表中不會呈現模型的子節點

• 參數模型僅支援顯示隱藏、刪除、重新命名、組合操作

• 點選模型列表下方「資料設定」可再次進行模型資料配置

2.2 更新參數模型

更新參數模型是指，更新參數模型在三維場景裏的生成、銷燬狀態。

1）進入三維自訂場景組件編輯介面，點選「模型>場景事件>更新參數模型」，再點選「新增更新參數模型」。

2）更新參數模型事件包括：事件名稱、指定模型、資料來源、模型名稱、模型位置五項設定。如下圖所示：

具體說明如下表所示：

3）更新規則

• 支援更新的操作包括：刪除、生成參數模型

• 透過 opType 指定更新類型

• 不同更新類型的具體取值：

• upsert：若資料已存在則更新，若不存在則新增

• delete：刪除匹配資料

• 若更新參數模型中資料出現重複，新增模型則不重複生成，刪除模型始終執行，後者改寫前者

注意：參數模型生成後會一直存在，如果需要在場景裏刪除生成後的參數模型，必須進行銷燬，即需要指定更新類型為“delete”銷燬模型 。

JavaScript 範例如下：

[
    {
        "id": "更新參數模型1",
        "data": [
            {
                "opType": "upsert",
                "name": "小車001",
                "position": "0,0,0"
            },
            {
                "opType": "delete",
                "name": "小車002",
                "position": "0,0,0"
            }
        ]
    }
]

範例範本下載：參數模型範例.fvs

3.1 資料準備

資料欄位要包含：生成的模型名稱、模型位置。

此處以父實體座標為範例，貨箱位置為貨箱生成位置的軌道模型名稱。

3.2 新增模型

新增一個新的貨箱模型到三維場景中，如下圖所示：

3.3 轉化為參數模型

選中貨箱模型，滑鼠右鍵選中「轉化為參數模型」，並且配置資料來源。

資料來源綁定「軌道貨箱生成」資料集，模型名稱選擇「貨箱名稱」，模型位置選擇「父實體座標」，配置參照模型名稱為「貨箱位置」。

3.4 配置資料圖層

為參數模型配置資料圖層，點選「資料」Tab，資料來源綁定「軌道貨箱生成」資料集，模型名稱選擇「貨箱名稱」。

新增一個「圖層更新事件」，選擇新增「資料標籤」執行動作，配置完執行動作後點選「確定」即可。

3.5 最終效果

三維場景裏自動在貨箱位置處生成 5 個貨箱，如下圖所示：

實現貨箱在軌道運輸板上實時生成的效果。

4.1 參數模型設定

按照 3.3 節配置參數模型，可以將配置的資料來源設定為空表，這樣就不會在編輯資料來源後三維場景裏自動生成模型。

4.2 新增更新參數模型事件

在三維組件編輯介面，點選模型，選擇右上角「場景事件->更新參數模型->新增更新參數模型」，配置對應的的 Key 值 。

注：不提供 websocket 資料源範例，需自行配置。

其中，WebSocket 資料範例如下：

id：事件名稱

name：模型名稱

opType：指定模型是生成/銷燬

position：模型位置

4.3 預覽效果

可以看到，下圖中不同軌道板上貨箱實時生成。