智慧大屏产品用户手册 静态阅读版

智慧大屏产品用户手册#

文档版本:V1.0
适用产品:智慧大屏 / 大屏设计器
适用对象:普通业务用户、可视化设计人员、数据实施人员和三维场景实施人员
更新日期:2026-11-05


0. 文档说明#

0.1 编写目的#

本手册用于指导用户完成智慧大屏的日常使用、资源准备、页面设计、数据绑定、交互配置、三维场景制作和发布访问。

主要内容包括:

0.2 适用读者#

本手册适用于以下用户:

用户类型 主要任务
业务用户 使用模板查看、创建和维护业务大屏
可视化设计人员 完成页面布局、组件样式、数据展示和交互设计
数据实施人员 配置数据源、数据集以及组件的数据字段
三维场景实施人员 制作地形、模型、标绘、POI 和漫游场景

本手册不包含平台侧的管理员配置,例如角色配置、权限配置、登录统计和公共资源管理。普通用户只需使用账号已授权的功能;遇到入口不可见或账号能力受限时,联系系统支持人员处理。

0.3 阅读约定#

0.4 功能使用前提#

开始配置大屏前,建议确认以下条件:


1. 产品概览#

1.1 产品定位#

智慧大屏是一款用于业务数据展示和可视化页面搭建的产品,主要提供以下能力:

1.2 典型使用场景#

1.3 核心使用流程#

准备数据源和数据
        ↓
准备数据集、地图、场景和素材
        ↓
创建大屏并设置画布
        ↓
拖入组件并完成布局
        ↓
绑定数据、调整样式、配置交互
        ↓
保存、预览并生成封面
        ↓
发布内部大屏或外部链接
        ↓
发布记录管理和日常维护

大屏设计不要求所有资源都在同一次操作中完成。可以先将页面结构和静态内容搭建完成,再逐步补充数据集、交互、场景和发布配置。

1.4 普通用户可见模块#

模块 主要用途
大屏管理 创建、设计、访问、复制、发布、置顶和删除大屏
模板管理 浏览、预览、复制、编辑和使用已有模板
素材管理 上传和管理图片、音视频及字体
自定义组件 创建和使用组合组件、脚本组件
数据源管理 配置数据库连接
数据集管理 配置数据查询、返回字段和动态参数
地图管理 管理地图层级和 GeoJSON 数据
场景管理 创建和编辑 3D-UE、3D-Cesium 场景
发布管理 查看发布记录、访问地址和链接状态

不同账号可见的模块和按钮由授权范围决定。

普通用户可见的大屏管理主界面
图 1-1 大屏管理主界面与功能入口

1.5 通用页面操作#

多数管理页面包含以下通用操作:

当页面中没有某个按钮时,通常表示当前账号没有该操作权限,或者当前资源状态不允许执行该操作。

1.6 常用状态说明#

状态 说明
未发布 大屏只在平台内编辑和预览
内部发布 平台内授权用户可以访问
外部发布 持有访问凭证的用户可以通过外部链接访问
已过期 外部链接超过有效期,需要重新发布或续期
已置顶 资源优先展示在列表中
未置顶 资源按默认顺序展示

2. 快速开始#

本章用于快速完成一张业务大屏。首次使用时,可以按照以下流程操作。

2.1 从零创建一张大屏#

  1. 登录系统,进入“大屏管理”。
  2. 在左侧选择大屏分组。
  3. 单击“新增”,填写大屏名称。
  4. 选择推荐分辨率,或手动填写大屏宽度和高度。
  5. 选择所属分组并保存。
  6. 在大屏卡片上单击“设计”,进入大屏设计器。
  7. 从左侧组件库拖入文本、图表、表格或装饰组件。
  8. 调整组件的位置、大小和层级。
  9. 在右侧“数据”页签中选择数据集并配置字段。
  10. 在右侧“样式”页签中调整颜色、字体、图表和边框。
  11. 根据需要配置交互事件和条件规则。
  12. 单击“保存”,再单击“预览”检查实际效果。
  13. 单击“生成封面”,更新大屏卡片封面。
  14. 返回大屏管理,发布大屏或复制访问地址。
新建大屏弹窗
图 2-1 新建大屏并设置名称、分辨率和分组

2.2 使用模板创建大屏#

  1. 进入“模板管理”。
  2. 选择模板分组,按名称查找模板。
  3. 单击“预览”,确认模板页面结构。
  4. 复制模板,或根据页面提供的入口使用模板创建大屏。
  5. 进入设计器后,替换模板中的数据、字段、图片和文案。
  6. 检查组件参数、交互条件和目标分辨率。
  7. 保存、预览并发布。

使用模板后仍应逐项检查数据和交互配置。示例数据可能与本单位的业务字段不一致。

模板管理页面
图 2-2 模板管理与模板预览入口

2.3 首次使用检查清单#


3. 登录与界面导航#

3.1 登录系统#

  1. 打开系统支持人员提供的访问地址。
  2. 输入账号和密码。
  3. 根据系统要求完成验证码或其他登录验证。
  4. 登录后进入系统首页。

登录失败、账号不可用或会话过期时,应联系系统支持人员确认账号状态。

3.2 主界面结构#

系统主界面一般包含以下区域:

系统主界面导航和内容区
图 3-1 系统主界面主要由模块导航、分组和内容列表组成

3.3 功能可见性说明#

3.4 消息通知#

大屏设计器顶部提供消息通知入口。

  1. 单击消息图标。
  2. 查看未读消息和近期通知。
  3. 单击单条消息将其标记为已读。
  4. 使用“全部已读”处理全部未读消息。

消息内容以系统实际展示为准。


4. 资源准备#

4.1 数据源管理#

4.1.1 功能说明#

数据源用于连接数据库,是数据集查询数据的基础。当前页面提供以下数据库类型:

数据源管理列表
图 4-1 数据源管理列表

4.1.2 新建数据源#

  1. 进入“数据源管理”。
  2. 在左侧选择数据源分组。
  3. 单击“新增”。
  4. 选择数据源类型。
  5. 填写数据源名称。
  6. 填写 JDBC URL。
  7. 填写数据库用户名和密码。
  8. 填写备注并选择分组。
  9. 根据需要配置连接池参数。
  10. 单击“测试”,确认连接成功。
  11. 单击“确定”保存。

数据源名称不能与已有数据源重名。JDBC URL 中的主机、端口和数据库名必须与实际环境一致。

新建数据源弹窗
图 4-2 新建数据源时配置类型、地址和账号

4.1.3 连接池参数#

常用连接池参数包括:

如果不确定参数含义,建议使用系统默认值。

4.1.4 编辑数据源#

  1. 在数据源列表中找到目标数据源。
  2. 单击“编辑”。
  3. 修改名称、地址、账号、备注或连接池参数。
  4. 如果不需要修改密码,将密码输入框留空。
  5. 重新执行连接测试。
  6. 单击“确定”保存。

4.1.5 删除数据源#

  1. 在数据源列表中单击“删除”。
  2. 阅读删除确认提示。
  3. 如果数据源已被数据集引用,应先处理引用关系。
  4. 确认后完成删除。

删除数据源可能影响依赖该数据源的数据集和大屏,执行前应确认影响范围。

4.1.6 常见问题#

4.2 数据集管理#

4.2.1 功能说明#

数据集用于定义大屏组件能够使用的数据范围、查询方式和输出字段。一个数据集可以绑定一个或多个大屏组件。

数据集模块支持以下类型:

类型 适用场景
原始数据集 直接查询单表或视图
自助数据集 使用自定义 SQL 加工数据
JSON 数据集 维护静态 JSON 数据
JS 数据集 使用 JavaScript 生成或处理数据
HTTP 数据集 调用外部 HTTP 接口
脚本数据集 执行 Groovy 等自定义脚本
动态表单数据集 查询系统动态表单数据
数据集管理列表
图 4-3 数据集管理列表和类型筛选

4.2.2 数据集列表与分组#

  1. 进入“数据集管理”。
  2. 在左侧选择分组。
  3. 在右侧按类型或名称查询数据集。
  4. 单击数据集名称所在行的“编辑”进入配置页。
  5. 使用分页切换页码或每页数量。

数据集分组支持新增、编辑和删除。删除分组时只删除分组本身,分组内的数据集会移动到上级分组;没有上级分组时归入“全部”。

4.2.3 新增数据集的通用流程#

  1. 在左侧选择数据集分组。
  2. 单击“新增”。
  3. 选择数据集类型。
  4. 填写数据集名称、分组和备注。
  5. 根据类型配置数据源、SQL、JSON、JS、HTTP 或脚本。
  6. 配置动态参数。
  7. 单击“解析并运行”或对应测试按钮。
  8. 检查数据预览是否返回正确数据。
  9. 检查输出字段和字段描述。
  10. 单击“保存”。

数据集名称不能为空,也不能与已有数据集重名。未通过测试或没有输出字段的数据集不能保存。

数据集编辑页面
图 4-4 数据集编辑器、输出字段和数据预览

4.2.4 原始数据集#

原始数据集适用于直接读取数据库表或视图。

  1. 选择数据源。
  2. 选择表或视图。
  3. 选择需要输出的字段;不选择时默认使用全部字段。
  4. 根据需要开启去重。
  5. 根据需要开启缓存。
  6. 执行测试。
  7. 配置输出字段描述和排序。
  8. 保存数据集。

4.2.5 自助数据集#

自助数据集适用于通过 SQL 完成关联、过滤、聚合和指标加工。

  1. 选择数据源。
  2. 选择语法类型“普通”或“Mybatis”。
  3. 在 SQL 编辑区编写查询语句。
  4. 单击“解析并运行”。
  5. 根据提示配置 SQL 参数。
  6. 检查数据预览。
  7. 配置输出字段描述和排序。
  8. 根据需要开启缓存。
  9. 保存数据集。

SQL 参数可以使用以下写法:

SQL 不能为空,返回结果应为对象数组。修改 SQL、参数或语法类型后,必须重新执行测试。

4.2.6 JSON 数据集#

JSON 数据集适用于维护静态指标、地图点位、榜单或演示数据。

  1. 在编辑器中输入 JSON。
  2. 确认根节点是数组。
  3. 确认数组中的每一项都是对象。
  4. 使用英文双引号,不使用注释和单引号。
  5. 单击“解析并运行”。
  6. 检查数据预览和输出字段。
  7. 保存数据集。

正确示例:

[
  {
    "name": "区域A",
    "value": 120
  },
  {
    "name": "区域B",
    "value": 98
  }
]

4.2.7 JS 数据集#

JS 数据集适用于生成演示数据、计算派生字段或进行轻量数据处理。

  1. 在 JavaScript 编辑区编写脚本。
  2. 使用 return 返回对象数组。
  3. 如使用动态参数,以 ${参数名称} 的形式引用。
  4. 单击“解析并运行”。
  5. 检查返回数据和输出字段。
  6. 保存数据集。

示例:

return [
  { name: '设备A', status: '运行', value: 92 },
  { name: '设备B', status: '待机', value: 68 }
]

4.2.8 HTTP 数据集#

HTTP 数据集适用于调用业务接口或外部数据服务。

  1. 选择调用方式为“前台代理”或“后台代理”。
  2. 填写完整的 HTTP 或 HTTPS 请求地址。
  3. 选择 GET 或 POST。
  4. 配置请求头、查询参数和请求体。
  5. 根据需要使用请求脚本或响应脚本处理数据。
  6. 执行测试。
  7. 检查输出字段并保存。

注意事项:

4.2.9 脚本数据集#

脚本数据集适用于 Elasticsearch、MongoDB、国产数据库或自定义 Java/Groovy 处理逻辑。

  1. 填写数据集名称、分组和备注。
  2. 在脚本编辑区编写 Groovy 脚本。
  3. 配置脚本参数。
  4. 单击“解析并运行”。
  5. 检查返回数据和输出字段。
  6. 根据需要开启缓存。
  7. 保存数据集。

页面提供 ES 案例入口时,可以参考示例脚本理解返回格式。

4.2.10 动态表单数据集#

  1. 填写数据集名称、分组和备注。
  2. 选择目标动态表单。
  3. 配置请求参数。
  4. 配置请求体。
  5. 配置响应脚本。
  6. 配置动态参数。
  7. 执行测试。
  8. 检查数据预览和输出字段。
  9. 保存数据集。

4.2.11 动态参数#

动态参数用于在数据集被组件调用时接收月份、区域、项目编号或设备类型等外部条件。

  1. 单击“SQL 参数”“脚本参数”或“动态参数”右侧的配置入口。
  2. 新增或修改参数。
  3. 填写参数名称、类型、是否必填、测试值和备注。
  4. 确认参数名称不重复。
  5. 保存参数配置。
  6. 重新执行数据集测试。

参数名建议使用稳定的英文名称。参数改名后,需要检查引用该数据集的大屏组件是否仍能正确传值。

4.2.12 输出字段#

  1. 数据集测试成功后,打开输出字段配置。
  2. 为每个字段填写业务含义清晰的描述。
  3. 调整字段排序。
  4. 原始数据集或自助数据集可以配置字段来源表。
  5. 保存字段配置。
  6. 再次确认数据预览。
  7. 保存数据集。

字段描述会显示在组件的数据字段选择器中,建议避免使用难以理解的技术字段名作为业务描述。

4.2.13 数据测试与缓存#

测试通过应满足以下条件:

部分数据集支持缓存。开启缓存后,后续调用会优先使用缓存数据。需要实时更新的数据集应谨慎开启,修改查询逻辑后应重新测试并确认缓存影响。

4.2.14 编辑和删除数据集#

编辑数据集:

  1. 在列表中找到目标数据集。
  2. 单击“编辑”。
  3. 修改配置。
  4. 重新执行测试。
  5. 检查输出字段。
  6. 保存数据集。

删除数据集:

  1. 在列表中单击“删除”。
  2. 查看引用关系提示。
  3. 如果存在引用,先调整引用该数据集的大屏组件。
  4. 确认后删除。

删除操作不可撤销,重要数据集应先确认影响范围。

4.3 地图管理#

4.3.1 功能说明#

地图管理用于维护大屏地图组件使用的行政区域层级和 GeoJSON 数据。

地图级别包括:

地图管理列表
图 4-5 地图管理和地图层级

4.3.2 新增地图#

  1. 进入“地图管理”。
  2. 在名称或标识输入框中输入查询条件。
  3. 单击“新增”。
  4. 选择上级地图。
  5. 填写地图名称和地图标识。
  6. 选择地图级别。
  7. 上传 GeoJSON 文件。
  8. 根据需要开启自动解析下一级。
  9. 单击“确定”保存。
新增地图弹窗
图 4-6 新增地图并上传 GeoJSON 配置

4.3.3 编辑和添加下级#

  1. 在地图列表中找到目标地图。
  2. 单击“编辑”修改基础信息或 GeoJSON。
  3. 已上传 GeoJSON 的地图可以单击“添加下级”。
  4. 填写下级地图的名称、标识和级别。
  5. 保存后检查树形层级。

4.3.4 删除地图#

  1. 单击目标地图的“删除”。
  2. 如果地图存在下级,阅读级联删除提示。
  3. 检查地图是否被大屏引用。
  4. 确认影响范围后执行删除。

4.3.5 GeoJSON 使用要求#

4.4 素材管理#

4.4.1 功能说明#

素材管理用于统一保存大屏中使用的图片、视频、音频和字体。

当前支持的文件类型:

类型 支持格式
图片 JPG、JPEG、PNG、GIF、BMP、SVG、WEBP、ICO
视频 MP4、MOV
音频 MP3
字体 TTF、OTF、WOFF、WOFF2、TTC
素材管理列表
图 4-7 素材管理和素材预览

4.4.2 上传素材#

  1. 进入“素材管理”。
  2. 在左侧选择素材分组。
  3. 单击“上传素材”。
  4. 选择一个或多个文件。
  5. 等待上传完成。
  6. 检查素材名称、格式和缩略图。
  7. 如需修改名称或分组,单击“编辑”。

建议使用易识别的素材名称,避免使用无意义的临时文件名。

4.4.3 查询和使用素材#

  1. 选择素材类型。
  2. 输入素材名称并查询。
  3. 将鼠标移到素材卡片上查看可用操作。
  4. 单击“预览”查看图片或媒体内容。
  5. 单击“链接”复制素材地址。
  6. 在大屏图片、视频或相关组件中选择该素材。

4.4.4 下载、编辑和删除#

素材被大屏或自定义组件引用时,不建议直接删除。应先完成引用调整并重新预览。

4.4.5 素材常见问题#


5. 大屏管理与设计#

5.1 大屏管理#

5.1.1 页面结构#

大屏管理页面由以下区域组成:

大屏管理和卡片列表
图 5-1 大屏管理页面

5.1.2 新建大屏#

  1. 在左侧选择目标分组。
  2. 单击“新增”。
  3. 填写大屏名称。
  4. 选择推荐分辨率。
  5. 确认大屏宽度和高度。
  6. 选择所属分组。
  7. 单击“确定”保存。

推荐分辨率包括:

画布宽度和高度可以根据实际显示设备调整。

新增大屏配置弹窗
图 5-2 设置大屏名称、分辨率、尺寸和分组

5.1.3 大屏卡片操作#

操作 用途
访问 打开大屏预览
设计 进入大屏设计器
发布 / 取消发布 修改大屏发布状态
详情 修改名称、分辨率、尺寸和分组
复制 创建当前大屏的副本
删除 删除大屏
存为模板 将当前大屏保存到模板管理
置顶 / 取消置顶 调整大屏在列表中的优先级

复制大屏后,应检查新副本的数据参数、资源引用和发布状态。

5.1.4 编辑大屏详情#

  1. 在大屏卡片上单击“详情”。
  2. 修改大屏名称。
  3. 修改推荐分辨率或画布尺寸。
  4. 修改所属分组。
  5. 确认后保存。

修改画布尺寸后,已有组件的位置和比例可能发生变化,应重新打开设计器检查布局。

5.1.5 删除大屏#

  1. 单击大屏卡片的“删除”。
  2. 阅读确认提示。
  3. 确认后执行删除。

删除前应确认当前大屏是否仍被业务使用,重要大屏建议先复制或保存为模板。

5.2 大屏设计器界面#

5.2.1 页面组成#

大屏设计器由以下区域组成:

大屏设计器整体界面
图 5-3 大屏设计器的顶部操作栏、组件区、画布和设置区

5.2.2 顶部操作栏#

顶部操作栏提供:

5.2.3 左侧导航#

入口 内容
图层 查看画布中已有组件及其层级
页面组件 信息、列表、控件、媒体、图表、3D、边框、装饰等组件
素材 选择已上传的图片、音视频和字体
自定义组件 选择组合组件和脚本组件
场景 选择已创建的 3D-UE 或 3D-Cesium 场景
模板 选择已有模板内容

5.3 画布基础操作#

5.3.1 添加组件#

  1. 在左侧展开“页面组件”。
  2. 选择组件分类。
  3. 将组件拖入画布。
  4. 在画布中调整组件位置和大小。
  5. 在右侧设置组件数据和样式。

5.3.2 移动和缩放组件#

5.3.3 多选和对齐#

  1. 按住需要多选的组件,或使用画布选择区域选中多个组件。
  2. 在顶部打开“对齐方式”。
  3. 选择左侧对齐、水平居中、右侧对齐、顶部对齐、垂直居中或底部对齐。
  4. 需要等间距排列时,选择水平均分或垂直均分。
设计器对齐方式菜单
图 5-4 多选组件后的对齐和均分菜单

5.3.4 拖动画布#

当画布大于当前显示区域时,可以按住空格键并拖动鼠标左键移动画布。

5.3.5 使用标尺和磁吸#

5.4 组件库#

5.4.1 信息组件#

组件 用途
文本 展示单行或多行标题、说明文字
多行文本 展示较长文本或换行内容
数字 展示核心数值
倒计时 展示剩余时间或倒计时
当前时间 展示系统当前时间
跑马灯 循环展示较长文字
指标卡 展示标题、指标值和辅助信息
天气 展示天气、温度和相关指标

5.4.2 列表组件#

组件 用途
表格 分列展示业务明细
排名表 展示排行榜或序列数据
轮播表 按行轮播展示表格数据
滚动列表 循环滚动展示列表内容

5.4.3 控件组件#

组件 用途
输入框 输入查询条件或参数
选择器 从数据集字段中选择一个值
时间选择器 选择时间
日期时间选择器 选择日期和时间
容器 容纳和组合其他组件
Tab 页 在多个内容页之间切换
通用树 展示层级数据并支持选择

5.4.4 图表组件#

图表组件包括:

5.4.5 三维图表#

5.4.6 边框和装饰#

5.4.7 媒体组件#

组件 用途
图片 展示静态图片或素材
播放器 播放视频
轮播器 循环切换图片或媒体

5.4.8 其他组件#

5.4.9 场景组件#

GIS+BIM 场景组件用于将已创建的三维场景放入大屏。

  1. 从左侧选择“场景”。
  2. 选择目标场景。
  3. 将场景放入画布。
  4. 调整场景组件尺寸。
  5. 在右侧配置场景数据和交互。

5.5 组件通用配置#

选中组件后,右侧通常出现以下页签:

并非所有组件都显示全部页签,应以当前组件的实际设置为准。

5.5.1 基础属性#

5.5.2 样式设置#

常用样式包括:

组件样式设置面板
图 5-5 组件的标题、位置、边框、旋转和基础样式设置

5.6 数据绑定#

5.6.1 数据来源#

组件支持的数据来源可能包括:

组件数据设置面板
图 5-6 组件数据来源和内容设置

5.6.2 绑定数据集#

  1. 选中组件。
  2. 打开右侧“数据”页签。
  3. 选择“数据集”作为数据来源。
  4. 选择目标数据集。
  5. 填写数据集要求的动态参数。
  6. 选择维度字段、指标字段或系列字段。
  7. 根据组件类型配置其他字段。
  8. 检查组件预览是否显示预期数据。

5.6.3 字段映射#

5.6.4 使用静态值#

  1. 将数据来源设置为“静态值”。
  2. 在文本内容或数值输入框中填写固定内容。
  3. 根据需要调整数字精度或显示格式。

静态值适合标题、说明文字和固定指标,不适合需要实时更新的数据。

5.6.5 使用表达式#

  1. 将数据来源设置为“表达式”。
  2. 单击表达式编辑入口。
  3. 选择数据集字段、其他组件值或常量。
  4. 编写表达式。
  5. 完成表达式配置。
  6. 在画布中检查计算结果。

表达式适合从一个或多个组件的数据中计算展示值。表达式依赖的组件或字段发生变化后,应重新检查结果。

5.6.6 数据处理脚本#

部分图表支持数据处理脚本。该脚本用于将数据集返回的数据转换为图表需要的格式。

  1. 打开组件的数据设置。
  2. 在数据处理脚本中编写转换逻辑。
  3. 确保输入数据和返回数据结构符合组件要求。
  4. 保存后检查图表是否正确渲染。

5.6.7 服务端分页#

表格类组件可以配置服务端分页。

  1. 打开“分页配置”。
  2. 选择开启或关闭服务端分页。
  3. 选择分页长度。
  4. 确认后端接口支持对应分页参数。

5.7 交互配置#

5.7.1 支持的交互事件#

常用交互事件包括:

不同组件支持的事件可能不同。

组件交互设置页签
图 5-7 组件交互事件入口

5.7.2 支持的交互动作#

动作 用途
传参 将一个组件的值传给其他组件或变量
跳转链接 打开指定页面或外部地址
显隐 控制组件显示或隐藏
请求数据 使用交互参数重新请求数据
切换视角 切换三维场景相机
场景对象显隐 控制场景中的 POI、模型或标绘
漫游 控制场景漫游的播放、暂停或停止
改变数据集 切换组件使用的数据集
自定义 调用组件或场景提供的自定义方法

5.7.3 新增交互事件#

  1. 选中需要配置交互的组件。
  2. 打开右侧“交互”页签。
  3. 单击“新增交互事件”。
  4. 在交互编辑器中新增事件。
  5. 填写交互名称。
  6. 选择触发事件。
  7. 设置前置事件;不设置前置事件时,该事件作为执行起点。
  8. 配置执行条件。
  9. 选择动作类型。
  10. 填写动作参数。
  11. 保存交互配置。
  12. 使用预览验证交互结果。
交互编辑器
图 5-8 交互编辑器和事件流向检查入口

5.7.4 前置事件与流向图#

5.7.5 传参示例#

选择器切换地区后,可以配置:

  1. 选择器触发“点击事件”或组件提供的值变更事件。
  2. 设置参数名称为 areaCode。
  3. 参数内容选择选择器的当前值。
  4. 目标图表在数据集参数中引用 areaCode。
  5. 触发请求数据动作。
  6. 检查图表是否按地区刷新。

5.8 条件样式#

条件样式用于根据数据值改变组件外观。

  1. 选中需要配置条件的组件。
  2. 打开右侧“条件”页签。
  3. 单击新增规则。
  4. 选择用于判断的字段。
  5. 选择运算符。
  6. 填写比较值。
  7. 选择“并且”或“或者”组合多个条件。
  8. 按需添加条件分组。
  9. 选择满足条件后的执行动作,例如文字颜色或进度颜色。
  10. 设置目标颜色。
  11. 保存规则并预览。

条件规则应尽量简单明确。多条规则同时命中时,应检查系统实际执行顺序。

条件样式设置面板
图 5-9 水波图组件的条件样式配置

5.9 图层管理#

  1. 在左侧单击“图层”。
  2. 查看画布中的全部组件。
  3. 单击图层名称选中组件。
  4. 使用图层操作调整显示、隐藏和层级。
  5. 根据需要重命名图层。
  6. 使用搜索框按名称查找图层。

合理命名图层可以降低复杂大屏的维护成本。

设计器图层面板
图 5-10 图层列表、搜索和组件层级

5.10 撤销、重做和历史操作#

5.10.1 撤销和重做#

5.10.2 历史操作#

  1. 单击顶部“历史操作”。
  2. 查看近期操作记录。
  3. 检查操作名称和时间。
  4. 如需恢复,可以使用对应的撤销或重做能力。

历史操作不能替代正式保存。完成关键步骤后应及时保存。

5.11 页面整体设置#

5.11.1 整体布局#

  1. 单击顶部“设置”或确保未选中具体组件。
  2. 打开右侧整体设置。
  3. 选择推荐分辨率。
  4. 查看或修改大屏宽度和高度。
  5. 选择自适应模式。
  6. 设置是否开启磁吸。
  7. 选择暗黑或明亮主题。

自适应模式包括:

模式 说明
无 不进行额外缩放
自动 按系统默认规则适配
宽度铺满 按可用宽度缩放
高度铺满 按可用高度缩放
双向铺满 宽高同时铺满
页面整体设置
图 5-11 大屏分辨率、自适应模式、主题和刷新设置

5.11.2 数据刷新#

单个组件刷新:

  1. 打开页面整体设置中的“定时器”。
  2. 关闭“批量管理”。
  3. 单击“新建”。
  4. 设置刷新时间,单位为秒。
  5. 选择需要刷新的组件。
  6. 保存页面设置。

批量刷新:

  1. 开启“批量管理”。
  2. 设置统一的刷新间隔。
  3. 确认需要实时刷新的组件都已绑定数据集。

刷新时间应根据数据变化频率和服务承载能力设置,不建议设置过短的刷新间隔。

5.11.3 多屏页面#

当前版本是否开放多屏页面功能以实际页面为准。如页面提供“新增大屏”“切换屏幕”和“删除屏幕”操作,可以按页面提示创建多个屏幕,并在各屏幕中分别配置内容。

如页面没有相关入口,不需要在普通编辑流程中配置多屏。

5.12 保存、封面与预览#

5.12.1 保存#

  1. 完成当前组件或页面配置。
  2. 单击顶部“保存”。
  3. 等待系统提示保存成功。
  4. 如保存失败,根据提示检查未完成的 Tab 配置、组件字段或数据配置。

保存按钮用于将当前设计保存到系统,不会自动发布大屏。

5.12.2 生成封面#

  1. 单击顶部“生成封面”。
  2. 等待系统生成并上传封面。
  3. 返回大屏管理查看卡片封面。

生成封面时,系统会截取当前画布内容。图片、视频或外部资源加载异常可能导致封面为空或显示不完整。

5.12.3 预览#

  1. 单击顶部“预览”。
  2. 系统保存当前内容并打开预览页面。
  3. 检查页面布局、数据、交互和资源加载。
  4. 关闭预览窗口并返回设计器继续修改。

预览是发布前的重要检查步骤。建议在目标分辨率下检查,而不仅在设计器缩放状态下查看。

5.12.4 清空画布#

  1. 单击顶部“清空”。
  2. 阅读清空确认提示。
  3. 确认后删除当前页面中的全部组件。

清空画布会影响当前页面内容。执行前应确认配置已保存或有可用副本。

5.12.5 离开设计器#

单击左上角返回按钮时,系统可能询问是否保存:

如果当前配置尚未保存,关闭浏览器标签页也可能导致修改丢失。

5.13 模板管理#

5.13.1 查看和查询模板#

  1. 进入“模板管理”。
  2. 在左侧选择模板分组。
  3. 输入模板名称并查询。
  4. 使用分页浏览模板。

5.13.2 使用模板#

  1. 在模板卡片上单击“预览”。
  2. 检查模板布局和内容。
  3. 使用模板创建大屏,或复制模板后编辑。
  4. 进入设计器替换数据和资源。
  5. 检查模板组件中的交互和条件。
  6. 保存并预览。
模板卡片操作
图 5-12 模板卡片上的访问和应用操作

5.13.3 将大屏保存为模板#

  1. 进入“大屏管理”。
  2. 在大屏卡片上单击“存为模板”。
  3. 按提示完成模板保存。
  4. 进入“模板管理”确认模板已经出现。
  5. 按需修改模板名称和分组。

5.13.4 模板其他操作#


6. 三维场景编辑器#

6.1 场景类型#

场景类型 适用场景
3D-UE 高质量三维、BIM、复杂模型和定制交互
3D-Cesium GIS、地形、影像、模型、标绘和漫游

6.2 场景管理#

6.2.1 查看和查询场景#

  1. 进入“场景管理”。
  2. 在左侧选择场景分组。
  3. 按场景类型或名称查询。
  4. 使用分页浏览场景。
场景管理列表
图 6-1 场景管理列表

6.2.2 新建场景#

  1. 单击“新增场景”。
  2. 填写场景名称。
  3. 选择场景类型。
  4. 3D-UE 场景填写 IP、端口和 URL 前缀。
  5. 选择推荐分辨率。
  6. 确认场景宽度和高度。
  7. 选择分组。
  8. 保存并进入设计。
新增场景弹窗
图 6-2 新建场景时选择场景类型和尺寸

6.2.3 场景卡片操作#

删除场景前,应检查场景是否被大屏引用。

6.3 场景编辑器界面#

场景编辑器包含:

三维场景编辑器
图 6-3 三维场景编辑器界面

6.4 场景公共操作#

6.4.1 保存和返回#

  1. 完成场景配置。
  2. 单击顶部“保存”。
  3. 等待保存成功提示。
  4. 返回场景管理时,根据提示选择保存或放弃未保存内容。

6.4.2 撤销和重做#

6.4.3 生成底图#

  1. 调整好场景视角和显示内容。
  2. 单击“生成底图”。
  3. 等待生成完成。
  4. 返回场景管理确认封面已经更新。

6.4.4 工具设置#

工具设置用于控制场景工具条、指北针和相关辅助显示。具体选项以页面实际配置为准。

6.4.5 3D-UE 场景设置#

  1. 打开“场景设置”。
  2. 修改 IP、端口或 URL 前缀。
  3. 单击“应用”。
  4. 检查场景是否重新连接成功。

6.5 地形管理#

  1. 在左侧选择“地形管理”。
  2. 选择“添加地形”。
  3. 填写地形数据地址。
  4. 确认后加载地形。
  5. 在对象管理或场景中检查地形显示。

如场景支持地形透明度、挖洞或图层显隐,可以在对应属性中设置。

场景地形管理
图 6-4 场景地形管理入口

6.6 模型管理#

6.6.1 添加 3D Tiles#

  1. 选择“模型管理”。
  2. 选择“添加 3DTiles”。
  3. 填写数据地址。
  4. 根据需要设置最大屏幕误差或其他参数。
  5. 确认并加载。
场景模型管理
图 6-5 场景中的 3D Tiles 和 GLB 模型入口

6.6.2 添加 GLB 模型#

  1. 选择“添加 glb”。
  2. 填写模型数据地址。
  3. 设置模型位置。
  4. 根据需要设置缩放比例、开挖边界等属性。
  5. 确认并加载。

6.6.3 模型操作#

6.7 影像管理#

支持的地图影像类型包括:

添加影像的一般步骤:

  1. 选择“影像管理”。
  2. 选择影像类型。
  3. 填写服务地址。
  4. 填写图层名称或图层标识。
  5. 选择影像格式。
  6. 设置最小级别、最大级别或图层索引。
  7. 确认并加载。
  8. 检查影像是否覆盖预期区域。
场景影像管理
图 6-6 TMS、WMS 和 WMTS 影像配置入口

6.8 标绘管理#

常用标绘类型包括:

6.8.1 绘制标绘对象#

  1. 打开“标绘管理”。
  2. 选择标绘类型。
  3. 在三维视口中选择位置或绘制路径。
  4. 在右侧属性面板设置颜色、宽度、高度、透明度、贴地和动画参数。
  5. 确认创建。
  6. 在对象管理中检查新对象。
场景标绘管理
图 6-7 点、线、面、导航线、光幕和水面等标绘入口

6.8.2 编辑和删除标绘对象#

  1. 在对象管理中搜索或选择对象。
  2. 查看对象名称和类型。
  3. 修改对象名称或属性。
  4. 需要删除时,确认后执行删除。

6.9 POI 管理#

6.9.1 放置 POI#

  1. 打开“POI 管理”。
  2. 选择“POI 标签”或“InfoPOI 标签”。
  3. 在三维视口中选择放置位置。
  4. 设置图标类型、名称和显示样式。
  5. 确认创建。
场景 POI 管理
图 6-8 POI 和 InfoPOI 放置入口

6.9.2 配置 InfoPOI#

可以配置:

6.9.3 数据集批量导入 POI#

  1. 选择数据集。
  2. 映射经度、纬度和高度字段。
  3. 如使用点集字段,选择对应的点集字段。
  4. 查看数据预览。
  5. 确认导入范围。
  6. 检查场景中的 POI 是否按预期生成。

6.10 相机管理#

  1. 将三维视口调整到目标视角。
  2. 打开“相机管理”。
  3. 设置当前位置为 Home 或新增相机快照。
  4. 填写相机名称。
  5. 保存相机。
  6. 使用定位或切换功能验证视角。

相机快照可以用于大屏交互中的“切换视角”动作。

场景相机管理
图 6-9 相机快照和视角管理

6.11 漫游管理#

6.11.1 相机漫游#

  1. 打开“漫游管理”。
  2. 选择“相机漫游”。
  3. 在场景中设置漫游路径。
  4. 配置移动速度、高度和其他参数。
  5. 保存并播放验证。
场景漫游管理
图 6-10 相机漫游、模型漫游和路径漫游入口

6.11.2 模型漫游#

  1. 选择模型或路径。
  2. 配置模型地址、移动速度、高度和运动模式。
  3. 保存漫游。
  4. 播放漫游并检查模型运动方向。

6.11.3 路径漫游#

  1. 绘制路径线。
  2. 配置路径线颜色、宽度和运动速度。
  3. 设置是否自动播放。
  4. 保存并预览。

6.12 对象管理#

对象管理用于统一查看场景中已经创建的元素。

  1. 在左侧展开“对象管理”。
  2. 输入名称搜索对象。
  3. 查看对象名称、类型和状态。
  4. 选择对象进行定位或编辑。
  5. 控制对象显示或隐藏。
  6. 删除不再使用的对象。

6.13 场景数据集#

  1. 选择目标数据集。
  2. 选择经度字段。
  3. 选择纬度字段。
  4. 根据对象类型选择高度、半径或点集字段。
  5. 检查数据预览。
  6. 将数据应用到场景。
  7. 检查生成对象的位置、高度和显示样式。

6.14 在场景中使用数据集#

场景数据集可以与以下对象关联:

数据集字段更新后,应重新加载场景并确认对象位置。

6.15 将场景添加到大屏#

  1. 打开目标大屏的设计器。
  2. 从左侧选择“场景”。
  3. 选择已经创建完成的场景。
  4. 将场景组件添加到画布。
  5. 调整组件尺寸和位置。
  6. 在右侧配置场景数据和交互。
  7. 保存并预览大屏。
  8. 检查场景在大屏中的加载、比例和交互。

6.16 场景常见问题#


7. 自定义组件#

7.1 组件类型#

自定义组件分为:

自定义组件管理
图 7-1 组合组件和脚本组件入口

7.2 组合组件#

7.2.1 新建组合组件#

  1. 进入“自定义组件”。
  2. 在左侧选择组合组件分组。
  3. 单击“新增组件”。
  4. 填写组件名称。
  5. 选择推荐分辨率。
  6. 填写大屏宽度和高度。
  7. 选择分组。
  8. 保存并进入设计。

7.2.2 编辑组合组件#

组合组件使用与大屏相同的设计器。

  1. 拖入需要组合的组件。
  2. 调整组件布局和层级。
  3. 配置样式、数据和交互。
  4. 保存并预览。
  5. 返回自定义组件列表。

7.2.3 使用组合组件#

  1. 打开大屏设计器。
  2. 从左侧选择“组件”。
  3. 选择目标组合组件。
  4. 将组件添加到画布。
  5. 根据组件配置绑定数据或参数。

7.3 脚本组件#

7.3.1 新建脚本组件#

  1. 进入“自定义组件”。
  2. 在左侧选择脚本组件分组。
  3. 单击“新增组件”。
  4. 填写组件名称。
  5. 选择组件类型。
  6. 选择推荐分辨率。
  7. 选择分组。
  8. 保存并进入编辑器。

脚本组件模板包括:

脚本组件列表
图 7-2 脚本组件列表和组件预览

7.3.2 编辑脚本组件#

编辑器包含以下区域:

操作步骤:

  1. 选择组件模板。
  2. 编写或替换组件模板代码。
  3. 编写组件配置代码。
  4. 检查预览是否正常。
  5. 调整组件尺寸和配置。
  6. 单击“生成图片”更新预览图。
  7. 单击“保存”。

如果替换模板,原有代码可能被覆盖,应在替换前确认。

脚本组件编辑器
图 7-3 脚本组件模板代码、配置代码和效果预览

7.3.3 使用脚本组件#

  1. 打开大屏设计器。
  2. 从左侧选择“组件”。
  3. 选择脚本组件。
  4. 添加到画布。
  5. 配置组件数据和参数。
  6. 预览并检查脚本组件是否正确读取数据。

7.4 自定义组件常见问题#


8. 发布与运维#

8.1 发布方式#

发布方式 访问范围 说明
内部发布 平台内授权用户 适合内部查看和使用
外部发布 持有链接的用户 生成带访问凭证的外部链接

8.2 发布大屏#

  1. 在设计器中保存并预览大屏。
  2. 返回大屏管理,找到目标大屏。
  3. 单击“发布”。
  4. 选择是否发布为外部链接。
  5. 如选择外部发布,选择链接有效期。
  6. 单击“发布并复制链接”或“发布”。
  7. 妥善保存外部访问地址。
发布大屏弹窗
图 8-1 选择外部链接发布和链接有效期

外部链接有效期包括:

8.3 发布管理#

8.3.1 查询发布记录#

  1. 进入“发布管理”。
  2. 输入大屏名称。
  3. 单击“查询”。
  4. 查看发布记录列表。

列表字段包括:

发布管理列表
图 8-2 发布记录、访问地址和链接状态

8.3.2 复制访问地址#

  1. 找到状态正常的外部发布记录。
  2. 单击地址旁的复制图标,或单击“复制链接”。
  3. 将地址发送给有权访问的用户。

8.3.3 取消发布#

  1. 找到需要取消的发布记录。
  2. 单击“取消发布”。
  3. 阅读确认提示。
  4. 确认后完成取消。

取消发布后,原访问链接将不能继续访问。

8.3.4 重新发布#

  1. 找到未发布或已过期的记录。
  2. 单击“重新发布”。
  3. 重新选择发布方式和有效期。
  4. 确认发布。
  5. 如生成新链接,重新分发地址。

8.3.5 删除发布记录#

失效或未发布的记录可以删除。

  1. 单击“删除记录”。
  2. 阅读确认提示。
  3. 确认后删除。

删除发布记录不会删除大屏本身。

8.4 访问发布大屏#

8.5 发布前检查#

8.6 日常维护建议#


9. 常见问题与故障排查#

9.1 功能入口与可见性#

9.1.1 看不到菜单或按钮#

可能原因:

处理方法:

9.1.2 有菜单但列表为空#

可能原因:

处理方法:

9.2 大屏设计#

9.2.1 组件拖入后不可见#

9.2.2 组件无法移动或缩放#

9.2.3 保存失败#

9.2.4 图片、视频或外链无法显示#

9.3 数据展示#

9.3.1 数据集没有数据#

9.3.2 字段选择为空#

9.3.3 图表请求失败#

9.3.4 编辑数据集后大屏仍显示旧数据#

9.4 交互与条件#

9.4.1 交互事件没有触发#

9.4.2 交互动作顺序错误#

9.4.3 传参后目标组件没有刷新#

9.4.4 条件规则没有生效#

9.5 场景与 3D#

9.5.1 UE 场景无法连接#

9.5.2 地形、模型或影像不显示#

9.5.3 标绘或 POI 位置错误#

9.5.4 漫游无法播放#

9.6 发布与访问#

9.6.1 发布按钮不可用#

9.6.2 外部链接无法访问#

9.6.3 取消发布后仍访问到旧链接#

9.7 截图与封面#

9.7.1 视频区域黑屏#

9.7.2 外部图片导致封面失败#

9.7.3 封面内容不完整#


10. 附录#

10.1 术语表#

术语 说明
大屏 由多个可视化组件组成的展示页面
模板 可复用于创建新大屏的页面结构
组合组件 由多个已有组件组合形成的自定义组件
脚本组件 通过代码模板开发的复用组件
场景 包含地形、模型、影像、标绘、相机或漫游的三维内容
数据源 数据库连接配置
数据集 定义查询方式、返回数据和输出字段
动态参数 组件调用数据集时传入的可变条件
输出字段 数据集执行后可供组件选择和展示的字段
表达式 使用字段、常量或组件值计算展示结果
交互事件 点击、双击、移入、移出或数据渲染等触发条件
前置事件 当前交互执行前必须完成的事件
内部发布 在平台内部按账号权限访问
外部发布 使用带访问凭证的链接访问

10.2 组件支持能力速查表#

组件类型 数据绑定 交互 条件样式 定时刷新
文本类 静态值、数据集或表达式 常用事件 视组件配置 视数据来源
数字类 静态值、数据集或表达式 常用事件 视组件配置 视数据来源
图表类 数据集或表达式 常用事件 部分图表支持 支持
表格类 数据集 常用事件 视组件配置 支持
控件类 数据集或静态选项 常用事件 视组件配置 视组件配置
媒体类 资源或数据字段 常用事件 视组件配置 视组件配置
场景类 场景配置和数据集 场景联动 视场景配置 视场景配置
装饰类 通常不需要数据 视组件配置 视组件配置 通常不需要

组件的“数据 / 样式 / 交互 / 条件”页签由组件自身配置决定。页面没有显示某个页签时,不需要为该组件补充对应配置。

10.3 分辨率建议#

分辨率 适用场景
1280×720 普通显示器、轻量展示
1920×1080 常规大屏、会议室和值班室
2560×1440 高分辨率显示器
3840×2160 4K 大屏
5120×2880 高分辨率拼接屏
7680×4320 超大分辨率展示

选择分辨率时应优先与终端实际分辨率一致,并在发布前使用目标终端预览。

10.4 发布状态与链接状态#

状态 说明
未发布 大屏只在平台内编辑和预览
内部发布 平台内授权用户可以访问
外部发布 通过外部链接和访问凭证访问
链接正常 当前链接可以访问
链接已过期 超过有效期,需要重新发布或获取新链接
大屏不存在 大屏被删除或发布记录关联的大屏已不可用

10.5 版本记录#

版本 日期 修改内容
V1.0 2026-11-05 根据大屏设计器用户手册大纲编写普通用户正文