数采平台接入
mocap 看板
平台里的数据更新后,
自动显示到现有网页中。
采集人员继续在数采平台完成日常工作。查看人员打开原来的看板网址,就能看到采集时长、录制条数、动作分类、上传情况和质检结果。
- 01 / 来源数采平台任务与采集记录
- 02 / 同步后台读取整理分类、核对、去重
- 03 / 保存保存统计结果保留最近成功数据
- 04 / 展示现有 Web 看板指标、图表与明细
怎么做,为什么这样做
在平台和看板之间,增加一个自动读取、整理数据的后台程序。
开通只读数据通道
请平台提供数据读取接口,让程序自动取数。
减少人工整理和重复录入,数据直接来自平台。
后台定时同步
检查新增、修改和补传的记录。
即使没人打开网页,数据也能持续更新。
沿用现有看板
把平台数据整理成看板能识别的格式。
图表、筛选和明细可以继续使用,开发工作更集中。
先保存,再展示
同步完成后,保存整理好的统计结果。
打开网页直接读取结果,不必等待平台逐条查询,加载更快。
按录制编号核对
修改和补传都更新同一条原记录。
重复同步或上传多个文件,都不会把一条录制多算。
逐批接入历史数据
先保留原值,核对一致后再改用平台数据。
避免旧数据丢失,也避免平台和飞书中的数据重复累计。
建议每分钟检查一次。在平台允许、网络正常的情况下,争取让已经可以读取的新数据在约 2–3 分钟内显示到网页,具体速度通过测试确定。
同步程序放在能访问数采平台的服务器上。如果平台只允许内网访问,就在内网运行,再把允许展示的统计结果同步给网站。
需要读取哪些数据
只同步统计所需的信息,原始动捕、视频和深度文件保留在原来的位置。
| 平台提供的数据 | 网页用来展示什么 |
|---|---|
| 采集日期、采集计划、录制编号 | 每日明细,以及 locomotion、HOI、HRI、Force-SONIC 分类 |
| 实际录制条数、采集有效时长 | 顶部累计指标、每日柱形图和折线图 |
| 动作名称、动作分类 | 动作分类统计和饼图 |
| 参与人员、采集设备 | 每日参与人数、人员和设备筛选 |
| 上传状态、实际存放路径 | 是否已上传,以及明细中的数据来源路径 |
| 质检结果、质检通过时长 | 质检有效时长及相关统计 |
统计时保留的规则
- 归类有依据。新数据按采集计划分类;历史数据按原有人名对应关系分类。数据属性沿用已提供的表格。
- 条数和人数不重复。一次录制产生多个文件,仍算一条;同一人当天参与多个任务,人数只算一次。
- 两种时长分开。采集有效时长与质检有效时长分别计算,计划目标不能当作实际完成量。
- 零和未知分清。没有采集的日期补 0;有采集但缺时长,显示未知。同步失败时继续显示上次成功的数据。
- 缺少数据不猜测。平台暂时没有的数据,保留现有可靠来源或显示“--”。
按什么顺序落地
- 1
确认平台能提供什么
请平台团队提供读取方式、只读权限和几条实际数据样例,确认条数、时长、分类和上传路径是否齐全。
目前尚未取得正式接口文档和实际返回数据,这一步决定能自动同步哪些内容。
- 2
先接通一小批数据
选择几天的数据,完成自动读取和网页展示,逐项核对日期、条数、时长、分类及路径。小范围验证,更容易发现统计差异。
- 3
加入自动更新和快速加载
后台定时更新,网页先显示最近保存的数据,再刷新新结果。上传、修改或补传后更新原记录;平台暂时连不上时,页面仍然可用。
- 4
核对历史,再扩大范围
确认平台记录与已有历史、飞书记录的对应关系,连续观察 3–5 个采集日。核对一致后,逐步接入全部需要展示的数据。
现有筛选、图表样式、四个饼图位置和“查看”占位按钮沿用当前设置。
需要平台团队配合什么
下面这段话,可以直接用于向平台团队说明接入需求。
我们需要把数采平台的数据自动读取到现有 mocap 看板中展示。请提供指定项目的数据读取接口、只读权限和样例数据,内容包括采集计划、录制编号、日期、实际条数、有效时长、动作分类、人员、设备、上传状态、存放路径和质检结果。同时请说明如何获取后续新增、修改及作废的记录,以及哪些数据允许在该网址展示。现有看板网址 ↗
确认是否包含未上传的数据
如果平台只记录上传完成的数据,需要保留其他来源补充未上传部分,才能统计完整的采集量。
暂时没有接口,也可以先开始
先用平台导出的表格更新看板作为过渡,自动定时更新在接口接通后实现。
完成后,看这四项
- 新数据能自动出现
- 旧数据不丢不重
- 明细与图表一致
- 打开无需等待平台响应