V2 录制部署说明

接口边界

• 原 /recordingTask、/fileExists 保持不变。
• /recordingTaskV2 兼容原整课请求并支持 onlyHighlight=1。
• /recordingTaskV2/scheduled 供 cron 触发，由 WebScreen 自行拉取 SaaS 任务。
• /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 搬运任务。

录制任务拉取配置：

"RECORDINGV2CONFIG": {
  "taskListUrl": "https://saas.xuedianyun.com/3m/api/recording/getRecordingTasksPrivate.do",
  "pageSize": 100,
  "maxPages": 1000,
  "maxTasksPerRun": 4,
  "maxFullConcurrent": 2,
  "apiTimeoutMs": 10000,
  "apiRetryCount": 2,
  "apiRetryBaseDelayMs": 500
}

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

cron

cron 不查询 SaaS，也不转换 taskList，只触发 WebScreen：

31 7-20 * * * curl -fsS -X POST http://127.0.0.1:3001/recordingTaskV2/scheduled >> /var/log/webscreen_recording_v2.log 2>&1

此入口只接受本机回环地址请求。

WebScreen 随后按照 RECORDINGV2CONFIG 分页调用 getRecordingTasksPrivate.do，并将任务交给 V2 录制服务。

/highlight/recording/scheduled 仅用于按站点批量补录，不作为正式任务入口。

灰度与回滚

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

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