1. 概述编辑
适用场景：安装了「FineVis数据可视化」插件的用户，可参考本文了解 FineVis 的相关功能。
1.1 版本
| 报表服务器版本 | 插件版本 |
|---|---|
| 11.5.1 | V4.1.0 |
注：使用该功能需购买「FVS三维组件-场景孪生」功能点，详情请咨询销售顾问。
1.2 应用场景
使用模型的点位数据（经纬度坐标/三维空间坐标），驱动模型在三维场景内变更位置，从而实现三维场景内的精确运动还原。如下图所示：
2. 功能介绍编辑
2.1 功能入口
在三维组件编辑界面，点击「模型>场景事件>模型实时运动>添加模型实时运动」，即可对模型实时运动进行配置。如下图所示：
2.2 前期准备
1）模型准备
注：仅支持匹配驱动模型的根节点，需将驱动目标作为独立模型添加至场景。
| 模型 | 要求说明 |
|---|---|
| 三维场景，比如生产车间、物流仓库 | 1）需要变更位置的模型，位置数据是相对坐标：三维场景的原点需要与移动物体的数据坐标原点重合，比如某个车间的AGV小车运动传输的相对位置是以车间某个柱子为原点，则三维场景的原点也需要与该柱子重合
2）需要变更位置的模型，位置数据是经纬度数据：需要确定三维场景原点的经纬度坐标点。详情请参见文档：三维场景坐标系
|
| 变更位置的模型，比如 AGV 小车 | 模型的正面朝向与 X 轴正方向朝向一致 注：导入场景时，模型默认以 X 轴正向为正面。后续旋转操作不会改变该正面定义 |
2）数据准备
| 数据 | 要求说明 |
|---|---|
| 数据格式 | 必备元素：
示例： 1、通过连接业务数据库获取到的数据
2、通过 WebSocket 获取到的数据 注：FineDataLink 实时任务中，支持将处理好的数据实时输出到 WebSocket，详情可参见：WebSocket输出
|
2.3 属性设置
模型实时运动的具体设置如下表所示：
| 设置 | 说明 |
|---|---|
| 名称 | 即模型实时运动事件的名称 支持自定义 不支持为空、不支持重名 |
| 数据来源 | 支持选择多种数据源，包括：数据集、WebSocket 数据来源的选择不同，配置项也不同：
注：数据请求间隔最小值为 1 秒
注：WebSocket 推送数据格式要求可参见：三维数据来源
|
| 模型名称 | 支持绑定字段/填写 key 值，用于识别数据中需要驱动的模型对象 名称类型：字符串 |
| 时刻 | 支持绑定字段/填写 key 值，用于识别数据中获取点位的时刻 注：仅支持 unix 时间戳格式，单位为毫秒 |
| 模型坐标类型 | 支持选择经纬度/空间坐标，用于区分驱动运动的点位坐标系
|
| 模型坐标 | 支持绑定字段/填写 key 值，用于识别数据中需要驱动的模型点位坐标 坐标类型：字符串 坐标格式：
|
2.4 注意事项
1）模型游标需置于模型整体的中心底部。
2）模型的正面朝向需平行于 X 轴正方向，同时保持缩放、旋转未设置。
3）需使用整体导出为一个 glb 文件的模型。
4）若需模型在实时运动过程中播放自身运动动画（如人物摆臂动画），需在建模时将该动画名称设置为「原地运动动画」。模型实时运动时，会自动调用该动画播放。
5）实时运动的位置还原，以模板在客户端预览的时间为准，在客户端打开模板预览时间之前的点位数据不会进行位置还原。
3. 示例编辑
点击下载本文模板：智慧仓储物流Demo
点击下载模板所需数据并解压：仓储物流.zip，将「仓储物流.db」文件放在 webapps/webroot/help 文件夹下，「货物仓储.xlsx」放在 webapps/webroot/WEB-INF/reportlets 文件夹下
3.1 数据准备
1）点击「服务器>定义数据连接」，新建数据连接，URL 选择 仓储物流.db 文件，如下图所示：
2）新建「文件数据集」，文件类型选择「Excel」，选择 货物仓储.xlsx 文件，勾选「第一行包含列标题」。如下图所示：
注：本模板已添加该文件数据集，只需将「货物仓储.xlsx」放在 webapps/webroot/WEB-INF/reportlets 文件夹下即可。
3）新建「内置数据集」，设置AGV小车的实时运动数据。数据需包含模型名称（字符串类型）、时间戳和坐标位置，如下图所示：
3.2 设置模型实时运动
1）选择「三维背景」，点击右侧「编辑组件」，即可进入三维组件编辑界面。
2）点击「模型>场景事件>模型实时运动>添加模型实时运动」，即可对模型实时运动进行配置。如下图所示：
3.3 效果预览
点击模板右上角「保存」按钮，再点击「预览」。预览后的效果如 1.2 节所示。