1. 概述编辑
1.1 版本
| 报表服务器版本 | 插件版本 |
|---|---|
| 11.0.22 | V3.3.0 |
注：该版本插件指共创测试版插件。
1.2 应用场景
在三维场景中，往往需要三维场景内的模型能够结合数据实时的反馈现实场景内对应实体的数量变化。FVS V3.3.0 版本，新增参数模型和「更新参数模型」事件，可实现在三维场景内实时生成某种三维模型，比如仓库内 AGV 小车数量增加，运输轨道上货箱增加等场景。
1.3 注意事项
参数模型数量设置上限为500个。
数据图层支持匹配参数模型生成的模型名称，匹配方式与普通模型保持一致。
参数模型支持设置显示隐藏。
参数模型不支持的效果：反射、模型动画及动画方案、线框风格、公共视角绑定、JS API。
2. 功能介绍编辑
2.1 参数模型
参数模型是指三维场景内能通过数据变化的模型。
1）进入三维自定义场景组件编辑界面，在模型列表中，右键根节点模型，点击「转为参数模型」，可将普通模型转换成参数模型。如下图所示：
2）点击「转为参数模型」后，需进行数据来源、模型名称、模型位置设置。
具体说明如下表所示：
| 配置 | 说明 |
|---|---|
| 数据来源 |
|
| 模型名称 | 定义生成的模型名称 可选择数据来源中已选数据集中含有的字段 |
| 模型位置 | 定义模型生成的位置 需要先选择坐标类型，才能配置具体位置。支持「经纬度」、「空间坐标」、「父物体坐标」
模型偏移：可选，用于设置参照模型的坐标基础上的偏移； 当前仅支持手动输入统一的偏移，不支持根据数据灵活定义； 形如：x,y,z，分别代表对应方向上的偏移距离； ； |
模型列表中不会呈现模型的子节点
参数模型仅支持显示隐藏、删除、重命名、组合操作
点击模型列表下方「数据设置」可再次进行模型数据配置
2.2 更新参数模型
1）进入三维自定义场景组件编辑界面，点击「模型>场景事件>更新参数模型」，再点击「添加更新参数模型」。
2）更新参数模型事件包括：事件名称、指定模型、数据来源、模型名称、模型位置五项设置。如下图所示：
具体说明如下表所示：
| 配置 | 说明 |
|---|---|
| 事件名称 | 默认名称为「更新参数模型x」 |
| 指定模型 | 用于指定当前场景内需要更新的模型，仅支持选择参数模型 |
| 数据来源 | 用于链接更新所需的数据来源，仅支持websocket的形式，需要配置数据源名称、url
|
| 模型名称 | 输入对应的key值，定义更新模型的名称 |
| 模型位置 | 根据参数模型配置时设置的模型坐标类型进行展示设置
|
支持更新的操作包括：删除、生成参数模型
指定更新类型的 Key 值：parametric_model
不同更新类型的具体取值
"delete_model" ：删除模型；
"create_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"
}
}
3. 示例编辑
3.1 数据集准备
数据字段至少需包含：生成的模型名称、模型位置。此处以空间坐标为示例：
3.2