三维场景更新参数模型

1.1 版本

注：该功能仅开放内测使用，如有需求，可扫描下方二维码填写申请

1.2 应用场景

在三维场景中，往往需要三维场景内的模型能够结合数据实时的反馈现实场景内对应实体的数量变化。FVS V3.3.0 版本，新增参数模型和「更新参数模型」事件，可实现在三维场景内实时生成某种三维模型，比如仓库内 AGV 小车数量增加，运输轨道上货箱增加等场景。

1.3 注意事项

• 单个参数模型在三维场景内生成数量上限为 500 个。

• 数据图层支持匹配参数模型生成的模型名称，匹配方式与普通模型保持一致。

• 参数模型支持设置显示隐藏。

• 参数模型不支持的效果：反射、模型动画及动画方案、线框风格、公共视角绑定、JS API。

2.1 参数模型

参数模型是指三维场景内能通过数据变化的模型。

1）进入三维自定义场景组件编辑界面，在模型列表>选中模型>右键根节点模型>点击「转为参数模型」，可将普通模型转换成参数模型。如下图所示：

2）点击「转为参数模型」后，需进行数据来源、模型名称、模型位置设置。

具体说明如下表所示：

3）「模型数据设置」配置完成后，返回模型列表，模型已转换为参数模型。

• 模型列表中不会呈现模型的子节点

• 参数模型仅支持显示隐藏、删除、重命名、组合操作

• 点击模型列表下方「数据设置」可再次进行模型数据配置

2.2 更新参数模型

更新参数模型是指，更新参数模型在三维场景里的的生成、销毁状态。

1）进入三维自定义场景组件编辑界面，点击「模型>场景事件>更新参数模型」，再点击「添加更新参数模型」。

2）更新参数模型事件包括：事件名称、指定模型、数据来源、模型名称、模型位置五项设置。如下图所示：

具体说明如下表所示：

3）更新规则

• 支持更新的操作包括：删除、生成参数模型

• 指定更新类型的 Key 值：parametric_model

• 不同更新类型的具体取值

• "delete_model" ：销毁模型；

• "create_model" ：生成模型；

• 若更新参数模型中数据出现重复，新增模型则不重复生成，删除模型始终执行，后者覆盖前者

注意：参数模型生成后会一直存在，如果需要在场景里删除生成后的参数模型，必须进行销毁，即需要指定更新类型为“delete_model”销毁模型。

JavaScript 示例如下：

{
    {
        "data": {
            "time": "1721216959",
            "modelName": "小车001",
            "modelPosition": "109.371947,97.809256,0" //经度、纬度、高度，其中高度可省略  匹配方式：时刻：data.time
        },
        "parametric_model": "create_model"
    }
 
 
    {
        "parametric_model": "create_model",
        "time": "1721216959",
        "modelName": "小车001",
        "modelPosition": "110.371947,97.809256,0" //经度、纬度、高度，其中高度可省略    匹配方式：时刻：time
    }
 
    {
        "parametric_model": "create_model",
        "time": "1721216959",
        "modelName": "小车001",
        "referenceModel": "父模型001" //参考模型
    }
 
    {
        "parametric_model": "delete_model",
        "time": "1721216959",
        "modelName": "小车002" //销毁生成的参数模型小车002
    }
}
显示代码

3.1 数据准备

数据字段要包含：生成的模型名称、模型位置。此处以父物体坐标为示例，货箱位置为货箱生成的轨道模型名称

3.2 添加模型

将货箱模型载入到三维场景里

3.3 转化为参数模型

选中货箱模型，鼠标右键选中「转化为参数模型」，并且配置数据来源。

模型名称选择「货箱名称」，模型位置选择「父物体坐标」，配置参数模型名称为「货箱位置」。

3.4 为参数模型配置数据图层

3.5 最终效果

三维场景里自动在轨道运输板上生成5个货箱。

如何实现货箱在轨道运输板上实时生成的效果。

4.1 参数模型设置

按照 3.3 节配置参数模型，可以将配置的数据来源设置为空表，这样就不会在编辑数据来源后三维场景里自动生成模型。

4.2 添加更新参数模型事件

「场景事件->更新参数模型->添加一个参数模型事件」，配置对应的的Key值。

数据解读：

• modeName：为模型名称

• parametric_model：指定模型是生成/销毁

• referenceModel：父物体名称

• time：时间戳
  

4.3 预览效果

可以看到，下图中不同轨道板上货箱实时生成。