跳到内容

使用 Harvest Job 保存直播片段 ​

更新时间

Harvest Job 是将端点中保存的历史直播片段提取出来并存储到 COS 的任务。创建后仅执行一次,与重新推送源流的任务不同。

将直播片段保存为文件

前置准备 ​

  • 目标端点必须已启用 Time-shifted Viewing。
  • 待提取的视频必须仍在实际的保存范围内。
  • 结束时刻必须为过去时间,开始 / 结束的间隔最长为 24 小时。
  • 准备与 StreamPackage 同地域的 COS 存储桶及读 / 写权限。
  • 每个任务使用唯一的 Manifest key。

如果复用相同的 Manifest key,新播放列表可能会覆盖已有的播放列表。不同任务的存储路径也要区分开。

控制台创建流程 ​

  1. 在 StreamPackage 控制台的 Harvest Jobs 中选择 Create Harvest Job。
  2. 指定任务 ID 并选择 Origin endpoint。
  3. 在 Date and time format 中选择 Epoch seconds 或 ISO-8601。
  4. 指定开始与结束时刻。
  5. 确认 COS 权限并选择同地域的存储桶。
  6. 指定包含存储桶内部路径和父播放列表文件名的 Manifest key。
  7. 如需完成通知,请配置 Callback HTTP URL。
  8. 确认内容后创建任务。

任务 ID 按官方说明使用英文 / 数字 / 下划线 / 连字符,最长 128 个字符。

时间指定示例 ​

项目ISO-8601 示例
开始2026-09-18T00:00:00Z
结束2026-09-18T00:10:00Z

上述日期仅为格式说明。请替换为实际已保存的历史片段。

状态与结果确认 ​

在列表或 Info 中确认任务状态及频道 / 端点 / 时间范围。完成后确认 COS 中的播放列表及其引用的分片是否存在,并实际播放。不要只看任务状态,还要比对开始 / 结束区间、时长、视频 / 音频。

API 的查询示例如下。请确认所用 SDK 的参数结构并替换任务 ID。

bash
tccli mdp DescribeStreamPackageHarvestJobs --region ap-seoul
tccli mdp DescribeStreamPackageHarvestJob --region ap-seoul --ID YOUR_JOB_ID

完成回调 ​

官方说明的回调包含以下字段。下列值为格式示例。

json
{
  "harvest_job_id": "demo_job",
  "state": "success",
  "time": 1789689600
}

回调 state 为 success 或 failed,time 为 Unix 时间。接收端应基于通知 ID 做幂等处理,并应用认证 / 重试策略。

结果确认与清理 ​

检查项确认内容
源流保存时移启用时刻与剩余的可用片段
时间范围开始 < 结束、结束时刻为过去、最长 24 小时
存储位置同地域的 COS 存储桶与权限
文件路径唯一的 Manifest key 与覆盖风险
播放结果确认分片是否存在及访问策略

任务记录的管理,以控制台 / API 中显示的当前状态和可用操作为准。

任务记录清理与 COS 结果文件的删除需分别确认。删除测试产物时,请指定准确的存储桶 / 对象路径,并先确认是否存在共享。

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages