mocap/方案文档
数据接入方案2026.11.18

数采平台接入
mocap 看板

平台里的数据更新后,
自动显示到现有网页中。

采集人员继续在数采平台完成日常工作。查看人员打开原来的看板网址,就能看到采集时长、录制条数、动作分类、上传情况和质检结果。

数据如何到达看板
  1. 01 / 来源数采平台任务与采集记录
  2. 02 / 同步后台读取整理分类、核对、去重
  3. 03 / 保存保存统计结果保留最近成功数据
  4. 04 / 展示现有 Web 看板指标、图表与明细
02

怎么做,为什么这样做

在平台和看板之间,增加一个自动读取、整理数据的后台程序。

可以怎么做为什么这样做

开通只读数据通道

请平台提供数据读取接口,让程序自动取数。

减少人工整理和重复录入,数据直接来自平台。

后台定时同步

检查新增、修改和补传的记录。

即使没人打开网页,数据也能持续更新。

沿用现有看板

把平台数据整理成看板能识别的格式。

图表、筛选和明细可以继续使用,开发工作更集中。

先保存,再展示

同步完成后,保存整理好的统计结果。

打开网页直接读取结果,不必等待平台逐条查询,加载更快。

按录制编号核对

修改和补传都更新同一条原记录。

重复同步或上传多个文件,都不会把一条录制多算。

逐批接入历史数据

先保留原值,核对一致后再改用平台数据。

避免旧数据丢失,也避免平台和飞书中的数据重复累计。

2–3分钟 · 目标更新延迟

建议每分钟检查一次。在平台允许、网络正常的情况下,争取让已经可以读取的新数据在约 2–3 分钟内显示到网页,具体速度通过测试确定。

同步程序放在能访问数采平台的服务器上。如果平台只允许内网访问,就在内网运行,再把允许展示的统计结果同步给网站。

03

需要读取哪些数据

只同步统计所需的信息,原始动捕、视频和深度文件保留在原来的位置。

平台提供的数据网页用来展示什么
采集日期、采集计划、录制编号每日明细,以及 locomotion、HOI、HRI、Force-SONIC 分类
实际录制条数、采集有效时长顶部累计指标、每日柱形图和折线图
动作名称、动作分类动作分类统计和饼图
参与人员、采集设备每日参与人数、人员和设备筛选
上传状态、实际存放路径是否已上传,以及明细中的数据来源路径
质检结果、质检通过时长质检有效时长及相关统计

统计时保留的规则

  • 归类有依据。新数据按采集计划分类;历史数据按原有人名对应关系分类。数据属性沿用已提供的表格。
  • 条数和人数不重复。一次录制产生多个文件,仍算一条;同一人当天参与多个任务,人数只算一次。
  • 两种时长分开。采集有效时长与质检有效时长分别计算,计划目标不能当作实际完成量。
  • 零和未知分清。没有采集的日期补 0;有采集但缺时长,显示未知。同步失败时继续显示上次成功的数据。
  • 缺少数据不猜测。平台暂时没有的数据,保留现有可靠来源或显示“--”。
04

按什么顺序落地

  1. 1

    确认平台能提供什么

    请平台团队提供读取方式、只读权限和几条实际数据样例,确认条数、时长、分类和上传路径是否齐全。

    目前尚未取得正式接口文档和实际返回数据,这一步决定能自动同步哪些内容。

  2. 2

    先接通一小批数据

    选择几天的数据,完成自动读取和网页展示,逐项核对日期、条数、时长、分类及路径。小范围验证,更容易发现统计差异。

  3. 3

    加入自动更新和快速加载

    后台定时更新,网页先显示最近保存的数据,再刷新新结果。上传、修改或补传后更新原记录;平台暂时连不上时,页面仍然可用。

  4. 4

    核对历史,再扩大范围

    确认平台记录与已有历史、飞书记录的对应关系,连续观察 3–5 个采集日。核对一致后,逐步接入全部需要展示的数据。

现有筛选、图表样式、四个饼图位置和“查看”占位按钮沿用当前设置。

05

需要平台团队配合什么

下面这段话,可以直接用于向平台团队说明接入需求。

对接需求
我们需要把数采平台的数据自动读取到现有 mocap 看板中展示。请提供指定项目的数据读取接口、只读权限和样例数据,内容包括采集计划、录制编号、日期、实际条数、有效时长、动作分类、人员、设备、上传状态、存放路径和质检结果。同时请说明如何获取后续新增、修改及作废的记录,以及哪些数据允许在该网址展示。
现有看板网址 ↗

确认是否包含未上传的数据

如果平台只记录上传完成的数据,需要保留其他来源补充未上传部分,才能统计完整的采集量。

暂时没有接口,也可以先开始

先用平台导出的表格更新看板作为过渡,自动定时更新在接口接通后实现。

完成后,看这四项

  • 新数据能自动出现
  • 旧数据不丢不重
  • 明细与图表一致
  • 打开无需等待平台响应

文档链接

复制下方链接即可分享。