WRITING / 2020.06.12

工程日志:视频编辑任务的协议与发布顺序

从编辑参数、异步处理、状态回调到多服务上线,整理媒体编辑功能的工程契约。

裁剪、拼接、字幕和封面等编辑能力跨越上传、任务编排、处理引擎与发布服务。稳定实现依赖一份清晰的任务协议。

参数描述意图

协议应表达时间线、素材引用、变换和输出要求,而不是把某条命令行直接暴露给上层。执行引擎可以升级,业务意图保持稳定。

创建任务即返回标识

媒体处理天然异步。创建接口完成校验和幂等落库后返回任务标识;调用方通过查询或回调获取状态,不持有长连接等待处理结束。

状态机

Created → Running → Succeeded
                └→ Failed / Cancelled

失败结果包含阶段、可重试性和安全摘要,不能只返回一段执行日志。

上线顺序

先上线能够兼容新字段的消费者,再开放生产者发送新协议;最后启用产品入口。回滚时反向关闭入口和生产者,避免旧消费者收到无法识别的任务。

跨服务功能的上线顺序本身就是协议设计的一部分。