V2 录制部署说明

接口边界

• 原 /recordingTask、/fileExists 保持不变。
• /recordingTaskV2 兼容原整课请求并支持 onlyHighlight=1。
• /fileExistsV2 是新功能的客户查询接口。
• /highlight/* 仅允许运维内网访问。

配置

启用高光前设置：

"HIGHLIGHTCONFIG": {
  "enabled": true,
  "apiBaseUrl": "https://saas.xuedianyun.com",
  "maxConcurrent": 2,
  "maxDurationMs": 21600000,
  "outputBaseUrl": "https://xdymp4.xuedianyun.com"
}

还需配置 OSS AccessKey、web_capture_c、显示服务及现有 OSS 搬运任务。

不录制站点已由 xdySDK 上游流程筛除，WebScreen V2 不再维护第二份站点策略。

外部 cron

正式任务链路由现有外部 cron 分发，不使用 WebScreen 本机的 /highlight/recording/scheduled 作为正式入口。

cron 继续调用 SaaS 的 getRecordingTasksPrivate.do，但需要将目标地址从：

POST /recordingTask

改为：

POST /recordingTaskV2

原来的字段映射可以继续使用，只需增加 onlyHighlight：

{
  "classId": "task.meetingNumber",
  "siteId": "task.siteId",
  "yymmdd": "原有课堂日期",
  "onlyHighlight": "task.onlyHighlight"
}

也可以不做映射，直接转发 SaaS 的完整 taskList；V2 同时兼容 classId/meetingNumber、taskId/id 两种字段名。id 和 beginTime/endTime 不是状态回写的必填字段。

灰度与回滚

1. 用旧格式调用 /recordingTaskV2，确认只生成整课文件。
2. 用 onlyHighlight=1 调用，确认只生成高光文件。
3. 验证 /fileExistsV2 可分别查询两种任务。
4. 确认两个老接口的请求和响应没有变化。

停用新功能时停止调用两个 V2 接口即可，原接口继续运行。