HIGHLIGHT_MP4_SPEC.md 805 字节

高光 MP4 内部约定

  • 一个 SaaS 高光记录生成一个独立 MP4。
  • 文件名为 {classId}_highlight_{highlightId}.mp4。
  • 回放地址携带绝对毫秒时间戳 recBeginTime/recEndTime。
  • 录制进程使用参数数组和 spawn(..., {shell:false}),不拼接未校验的 shell 输入。
  • 临时文件完成并校验非空后,原子移动到正式 media 目录。
  • 相同 siteId + highlightId 不重复进入队列。
  • 本地文件或 OSS 对象已存在时不重复录制。
  • SaaS 高光接口失败不能当作“没有高光”。
  • V2 客户查询只读取任务创建时保存的高光清单。

文件位置:

本地:media/{siteId}/{yyyyMMdd}/{classId}_highlight_{highlightId}.mp4
OSS:oss/{siteId}/{yyyyMMdd}/{classId}_highlight_{highlightId}.mp4