FVS自定义模型组件

适用场景：安装了「FVS大屏编辑模式」插件的用户，可参考本文了解 FVS 模板的相关功能。

注：不支持移动端。

1.1 版本

1.2 应用场景

「自定义模型」组件无需依托于三维城市组件，支持用户生成空场景，上传 glb 格式的自定义模型，通过组件事件和数据图层，实现独立的三维模型效果。

注：关于 glb 文件说明请参见 glb格式说明 。

应用示例文档请参见：构建3D园区监控场景 。模型资源请点击下载：智慧园区监控glb资源.zip 。

效果如下图所示：

新建一个 FVS 大屏模板：

新增一个「自定义模型」组件，点击「编辑组件」，进入自定义模型编辑页面。如下图所示：

3.1 创建场景

若首次编辑该自定义模型组件，则需要先创建场景。

创建场景有两种方式：生成空场景，导入已有场景。

3.1.1 生成空场景

生成空场景，FVS 提供两种场景风格：实景风格、科技风格。默认选中实景风格，如下图所示：

注：V1.11.0 版本之前是科技网格风格、科技丰巢风格和拟真风格，V1.11.0 版本对其进行了整合优化。

3.1.2 导入已有场景

若用户获得了他人给与的 .scene/.fcust 文件类型的自定义模型场景，用户在此步骤可直接导入。如下图所示：

3.2 导出场景

在自定义模型编辑界面，用户可导出当前场景。

导出场景时，会包括场景风格、右侧「场景」配置和「模型」配置，生成 .fcust 文件。

注：V1.3.0 之前的版本导出场景为 .scene 文件格式。

导出的文件可参考上文 3.1.2 节，在其他自定义模型组件导入使用。

3.3 设置场景属性

添加场景后，可对场景的属性进行配置，如下图所示：

注：V1.11.0 版本对场景属性做了大量优化，旧版本插件文档可参考 V1.11.0 版本之前的自定义模型组件 。

4.1 上传自定义模型

4.1.1 上传新模型

首先用户需要通过建模软件生成 .glb 格式的自定义模型。

在组件编辑界面，点击右侧配置栏的「模型>添加模型对象>自定义模型」，点击「上传新模型」，选择本地准备好的 .glb 文件类型的自定义模型，即可上传到模板中。

注：glb 文件名称中不得包含【】中提到的字符 【 ? ! @ # $ ^ & % * + , : ; = ' \ " ` < > () [] {} / | 空格 】 。

为了避免自定义模型在使用时过于卡顿甚至崩溃，V1.6.0 版本的插件新增上传限制，限制上传的模型网格数（Mesh 数）不能超过 3000 。否则提示上传失败，请精简后重新上传。

但此限制阻断用户使用影响较大，V1.7.0 版本插件优化该限制，可成功上传，但仍弹出强提示，建议精简模型。

点击「查看帮助」，可查看网格数过多的影响以及如何优化网格数。如下图所示：

4.1.2 模型预处理

1）数据预处理

支持调整模型的显示层级。默认层级上限为 2。

上传模型时设置的显示层级不可撤销，适用于所有使用该自定义模型的组件。

例如一个模型是一个班级，班级又分为两组人，每组里面又分为 6 个单独的同学。

0 级代表模型为 1 个整体，班级不可拆分。1 级代表可点击小组。以此类推。

2）风格预处理

V1.7.0 版本新增功能，可选择是否「启用线框风格」，启用后可选择「默认线框」或「自定义线框」。

更多内容请查看文档：FVS自定义模型线框风格 。

4.2 添加自定义模型

选择配置栏「模型>添加模型对象>自定义模型」，选中上传的任意一个模型，点击「完成」，模型即被添加到「模型列表>自定义模型」处，如下图所示：

注：若添加的自定义模型在中间展示区不显示，一般都是因为模型太大， 需要将视角拉远/模型缩放后才能正常显示。

添加模型会检测当前场景的 fps（帧率），如果小于 15，则提示「检测到场景帧数较低，是否开启流畅效果」

开启流畅效果可有效提升使用体验，但会关闭部分特效配置，被关闭的特效配置项可手动重新打开。

4.3 模型配置

选中模型列表中的自定义模型，支持配置相关模型属性。

按照上传模型时设置的显示层级，可选中模型中的部分小模型，对其属性进行单独配置。不会影响其他部分的模型。如下图所示：

各属性设置项详细说明如下表所示：

4.4 模型选中和移动

1）V1.12.0 版本之前，仅支持从右侧模型列表选中模型，V1.12.1 及之后版本，支持直接点击模型选中，列表中被选中的模型高亮。点击非模型外的区域或上方工具栏的「取消选中」按钮，即可取消选中模型。

注：仅支持选中 mesh 。

2）在模型列表点击模型名称右侧的「聚焦」按钮，则可切换视角。不支持直接选中编辑界面中的模型。

注：V1.5.1 版本之前的插件中，选中模型就会自动切换到该模型的视角。

3）选中模型后，会出现位移工具，拖动位移工具即可调整模型位置。V1.6.1 版本及之后的插件，位移工具新增旋转和缩放效果。

• 拉动 X、Y、Z 轴的顶端箭头，可移动模型位置

• 拉动 X、Y、Z 轴直线上的小方块，可改变缩放比例，右侧属性面板中的「缩放」值随之变化

• 鼠标悬浮圆圈，移动鼠标可改变旋转角度，右侧属性面板中的旋转角度随之变化

操作演示如下所示：

5.1 数据图层-数据集

1）在绑定数据前，必须确保数据集中的模型名称与 4.3 节模型配置中的模型名称是一致的，这样才能正常匹配并显示。

注：选中模型时，不能看见模型内容的对象，是一个空对象，不支持匹配数据。

2）自 V1.4.0 版本起，模型内容支持绑定多个字段。如下图所示：

5.2 数据图层-标签

1）内容

标签显示的内容默认为绑定的模型名称和模型内容，取消勾选则不显示。点击右侧「格式」可设置数据显示的格式类型。如下图所示：

自 V1.4.0 版本起，标签内容还支持以富文本的形式编辑自定义内容，可选择数据字段，也可直接输入文本。如下图所示：

2）字符缩放

可设置标签内容字符缩放的比例，范围为 1-10。点击右侧  按钮可设置标签内容的文字颜色。效果如下图所示：

3）色相

通过滑动色相值，可改变标签背景的颜色。效果如下图所示：

4）显示形式

「始终显示」时标签则一直显示于界面，「悬浮显示」时，则在预览模板时鼠标悬浮才显示标签。

5.3 数据图层-数据预警

自 V1.4.0 版本起，数据图层中新增数据预警设置，可添加多个数据预警，实现满足某个条件时，显示不同的预警内容。

添加预警后，可控制预警的开启与关闭。如下图所示：

注：当设置了多个条件，但条件存在冲突时，以下方的条件为准。

1）点击「添加数据预警」，弹出设置框。输入预警名称后，点击「添加条件」才可编辑条件。

2）在选中一个条件的情况下，才能编辑该条件的内容。

预警对象可选择该数据图层绑定的名称或内容；预警条件的值可设置为自定义内容，自定义公式或字段。

如下图所示：

3）当需要同时满足多个条件时，可通过连接线上的按钮  新增条件，在条件连接线上选择条件之间的关系为「且」还是「或」。如下图所示：

注：初始条件默认自带关系属性为「且」，连接线上的关系属性绑定的是第二个条件，选中并移动条件时，其属性「且/或」会根据条件产生变化。

例如设置「条件1 或 条件2」，如下图所示：

将 条件1 下移，会变成「条件2 且 条件1」。如下图所示：

4）鼠标悬浮在某条件上时，出现按钮「+组合条件」，表示可以给当前条件再添加子条件。

添加的组合条件前的 icon 可以收起或展开，收起时表现为一个组合条件，展开时表现为子条件树。如下图所示：

5）条件操作项说明如下表所示：

6）预警内容：预警内容包含「预警标签」和「预警样式」设置项。默认均为红色。如下图所示：

注：符合预警条件的数据，预警标签内容会取代原标签内容。

6.1 操作说明

自定义模型组件预定义了三个视角，可一键调整：顶视图、主视图、侧视图。

鼠标左键、右键、滚轮均可用于视角调整。点击编辑界面左上角的「操作说明」弹出对应操作演示。

1）鼠标左键：按住鼠标左键拖动，可旋转当前视角。

2）鼠标右键：按住鼠标右键拖动，可平移/拉升/降低视角。

3）鼠标滚轮：滚动鼠标滚轮，可放大/缩小视角。

6.2 调整视角的方法

支持两种方式手动调整场景视角。

6.2.1 在画布界面调整

在画布页面，选中组件，点击右上角「视角调整」按钮，即可在组件区域内使用鼠标调整视角，按钮变为「完成」按钮。

调整完成后，鼠标点击右上角「完成」按钮，或点击组件外任意区域，即可保存最终视角。

注：V1.11.1 版本之前的组件只能通过点击组件外区域保存调整后的视角。

6.2.2 在模型编辑界面调整

用户在自定义模型编辑页面，通过鼠标可直接调整模型的显示视角，点击「返回大屏编辑器」，即可自动保存最终视角。如下图所示：

7.1 数据图层对点击事件的影响

自定义模型组件配置「交互>点击事件」时，是按照模型的层级去触发的，数据图层匹配到了哪一层数据，点击事件就作用于哪一层模型。

例如上传模型时设置层级为 2，配置数据图层时，同时添加了层级 0 和层级 1 的数据图层。如下图所示：

则在自定义模型组件「交互>点击事件」中，层级 1 的点击事件生效，层级 0 的点击事件不生效。如下图所示：