1. 概述编辑
1.1 版本
| 报表服务器版本 | 插件版本 |
|---|---|
| 11.0.22 | V3.3.0 |
1.2 应用场景
在三维场景中，往往需要模型能够结合数据实时的反馈现实场景内对应的变化。V3.3.0 版本，FVS 三维自定义模型新增「场景事件>模型数据应用」事件设置。模型数据应用事件支持设置显示/隐藏和模型动画功能。
通过显示/隐藏功能，用户可以实时切换模型的显示状态，以反映现实场景中实体数量的变化，例如仓储货架上的货物数量或园区楼层的建设状态。
通过模型动画功能，用户可以利用数据信号驱动模型的动画播放，模拟设备的工作状态等，从而实现更加直观和动态的场景展示。
2. 功能介绍编辑
2.1 添加模型数据应用事件
1）进入三维自定义场景组件编辑界面，点击「模型>场景事件>模型数据应用」，再点击「添加模型数据应用事件」，进入事件设置面板。
2）「模型数据应用」事件设置包括事件名称和数据来源。
事件名称：设置事件的名称，默认为「模型数据应用事件X」，支持自定义，不支持为空。
数据来源：支持数据集和 websocket 两种数据来源。具体说明如下表所示。
| 数据来源 | 图示 | 说明 |
|---|---|---|
数据集 |  |
注：支持基于 websocket 的数据推送更新。 |
websocket |  |
|
3）支持添加多个「模型数据应用」事件，执行顺序按照列表自上而下执行。事件支持再次编辑、重命名、复制、删除以及关闭。
2.2 添加执行动作
设置完数据来源后可添加具体的执行动作，支持设置显示隐藏、动画播放。
2.2.1 显示隐藏
「显示隐藏」执行动作支持根据数据，动态控制指定模型的显示和隐藏状态。
注：需要控制显示隐藏的模型，建议作为独立的 glb 模型文件；多层级的模型结构建议父节点设置为空节点。
支持设置「执行条件」和「执行动作」，具体说明如下表所示：
| 配置 | 说明 | |
|---|---|---|
| 执行条件 | 不允许为空
| |
| 执行动作 | 动作名称 | 设置执行动作的名称 |
| 目标对象 | 事件作用的模型，支持数据指定和手动指定
| |
| 状态设置 | 支持设置显示、隐藏两种状态 | |
2.2.2 模型动画
「模型动画」执行动作支持根据数据，动态控制指定模型的模型动画播放状态。
支持设置「执行条件」和「执行动作」，具体说明如下表所示：
| 配置 | 说明 | |
|---|---|---|
| 执行条件 | 同「显示隐藏」 | |
| 执行动作 | 动作名称 | 同「显示隐藏」 |
| 目标对象 | 事件作用的模型，支持数据指定和手动指定
注：可选择模型列表内已有的所有模型中的动画，不支持线框动画。
注：「动画名称」支持为空，为空时默认播放模型动画列表中的第一段动画。
| |
| 播放命令 | 支持设置开始播放、暂停播放和退出播放 | |
| 命令时机 | 仅在「播放命令」选择「开始播放」时出现 支持设置立即播放动画和延迟播放动画 | |
| 播放方式 | 仅在「播放命令」选择「开始播放」时出现 支持设置单次播放和循环播放 | |
3. 示例编辑
3.1 数据准备
数据集至少需包含以下字段：模型名称、动画名称、条件判断字段。
本次示例以货架动画为例，模型含有进出取货的动作 Animation。当运动状态为运行时，播放 Animation 动画，否则处于暂停状态。
3.2 模型准备
将货架取货手臂作为单独的一个 glb 模型，且设置有取货动画。
3.3 添加模型数据应用事件
1）进入三维自定义场景组件编辑界面，点击「模型>场景事件>模型数据应用」，再点击「添加模型数据应用事件」，进入事件设置面板。
2）事件名称设置为「货架运动状态」，数据来源选择「数据集>货架运动状态」。
3）点击「添加执行动作」，添加模型动画。
分别添加两个执行动作，具体设置如下图所示：
运行状态：当运动状态字段为运行时，则对应的模型需要播放运行动画。
暂停状态：当运动状态字段为暂停时，则对应的模型需要暂停运行动画。
