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