1. 概述
适用场景：安装了「FVS大屏编辑模式」插件的用户，可参考本文了解 FVS 模板的相关功能。
1.1 版本
| 报表服务器版本 | JAR包 | FVS大屏编辑模式（beta版）版本 | 功能变更 |
|---|---|---|---|
| 11.0 | 2021-11-15 | V1.0.0 | - |
| 11.0.2 | - | V1.2.0 | 上传自定义模型时，支持设置模型显示层级 |
1.2 功能简介
「三维城市」组件支持用户上传自定义模型，通过组件事件和数据图层，可实现智慧园区效果，如下图所示：
1.3 操作步骤
本文将以搭建一个智慧园区作为示例，建议操作步骤如下表所示：
注：本文是在无三维城市作为背景的情况下，搭建智慧园区，因此导入一个空场景即可，用户也可以将自定义模型和三维城市结合使用。
| 序号 | 步骤 | 简介 |
|---|---|---|
| 1 | 模板准备 | 新建大屏模板，新建页面，新增「三维城市」组件，编辑组件 |
| 2 | 导入空场景 | 导入空场景 |
| 3 | 添加自定义模型 | 上传本地制作的自定义模型，添加到自定义模型列表 |
| 4 | 配置自定义模型 | 调整自定义模型的位置，视角，大小，名称，模型动画等 |
| 5 | 数据管理 | 添加数据集，配置数据图层，让数据和模型相结合 |
| 6 | 添加交互事件 | 通过添加交互事件，实现点击模型，传递参数/跳转分页等交互效果 |
2. 新建组件
新建一个FVS大屏模板：
新增一个「三维城市」组件，点击「编辑组件」，进入三维城市编辑页面。如下图所示：
3. 导入空场景
本示例提供一个空的场景，请下载到本地并解压：空.zip
点击「创建场景>导入已有场景」，导入本地空场景。如下图所示：
注：本文是在无三维城市作为背景的情况下，搭建智慧园区，因此导入一个空场景即可，用户也可以将自定义模型和三维城市结合使用。
4. 上传自定义模型
首先用户需要通过建模软件生成.glb格式的自定义模型。
自定义模型制作完成后，建议用户可在建模软件中合并mesh，减小模型大小会提升预览流畅度，建议模型大小不超过50M。
在三维城市组件编辑界面，点击右侧配置栏的「模型>添加自定义模型」，点击「上传新模型」，选择本地准备好的.glb文件类型的自定义模型，即可上传到模板中。
由于一个模型中可能存在多个层级，例如一个厂区模型中分为多个设备，需要对厂区内的各个设备进行数据匹配和交互，此时需要精确到底层设备。
V1.2.0 及之后版本的插件，支持调整模型的显示层级。默认层级上限为2。上传模型时设置的显示层级不可撤销，适用于所有使用该自定义模型的组件。
例如一个模型是一个厂区，厂区又分为三个设备，每个设备里面又分为多个零件。0级代表模型为1个整体，厂区不可拆分。1级代表可点击单个设备。以此类推。
5. 添加自定义模型
选择配置栏「模型>添加自定义模型」，选中上传的任意一个模型，点击「完成」，模型即被添加到「模型列表>自定义模型」处，如下图所示：
注：若添加的自定义模型在中间展示区不显示，一般都是因为模型太大， 需要将视角拉远/模型缩放后才能正常显示。
6. 自定义模型配置
模型列表中的自定义模型支持重命名、隐藏、删除。禁止完全一样的命名。
选中模型列表中的自定义模型，支持配置相关模型属性。
右上角「模型动画管理」，若模型中存在动画效果，可以通过添加动画方案，触发动画。
| 属性 | 简介 |
|---|---|
| 模型名称 | 支持自定义命名模型名称 |
| 缩放 | 支持缩放模型的长宽高 若勾选「固定比例」，长宽高等比缩放 |
| 位置 | 调整模型在组件中的位置 |
| 旋转 | 调整模型的展示视角 |
V1.2.0 及之后版本的插件，按照上传模型时设置的显示层级，可选中模型中的部分小模型，对其属性进行单独配置。不会影响其他部分的模型。如下图所示：
7. 配置数据图层
三维城市组件中支持添加四种数据图层：点、柱体、线、模型。
一般如不使用三维城市模型，仅使用自定义模型，那么就只添加「模型-数据图层」即可。
V1.2.0 及之后版本的插件，按照上传模型时设置的显示层级，匹配模型-数据图层。
例如设置显示层级为2层。第一层模型名称为「玩具」，第二层模型名称为「人偶」、「房屋」，第三层模型名称为「小明」、「小红」、「客厅」、「卧室」。
那么仅可匹配模型名称为「玩具」、「人偶」、「房屋」的数据，无法匹配模型名称为「小明」、「小红」、「客厅」、「卧室」的数据。
8. 添加点击事件
完成自定义模型配置后，点击「返回大屏编辑器」，自动保存配置，并回到画布界面。
选中三维城市组件，点击配置栏「交互>点击事件」，为模型添加JavaScript事件。
设置参数名称为「name」，参数类型为「当前组件字段」，参数内容为模型名称
JavaScript代码如下：（含义：点击名称为总控室的模型，就跳转到名称为总控室的分页）
if(name=='总控室'){
duchamp.switchStory("总控室");
}
V1.2.0 及之后版本的插件，按照上传模型时设置的最高显示层级，匹配模型名称。
例如设置显示层级为2层。第一层模型名称为「玩具」，第二层模型名称为「人偶」、「房屋」，第三层模型名称为「小明」、「小红」、「客厅」、「卧室」。
那么仅可匹配模型名称为「人偶」、「房屋」的数据，无法匹配模型名称为「玩具」、「小明」、「小红」、「客厅」、「卧室」的数据。
9. 已完成模板
已完成模板请参见：FVS自定义模型示例.fvs
10. 注意事项
若在模板中上传了一些和环境有关的自定义模型元素，在编辑三维城市组件时，会提示「引入了内部特性，非产品功能，请勿用于实施！」
