使用 Harvest Job 保存直播片段
Harvest Job 是将端点中保存的历史直播片段提取出来并存储到 COS 的任务。创建后仅执行一次,与重新推送源流的任务不同。
前置准备
- 目标端点必须已启用 Time-shifted Viewing。
- 待提取的视频必须仍在实际的保存范围内。
- 结束时刻必须为过去时间,开始 / 结束的间隔最长为
24 小时。 - 准备与 StreamPackage 同地域的 COS 存储桶及读 / 写权限。
- 每个任务使用唯一的 Manifest key。
如果复用相同的 Manifest key,新播放列表可能会覆盖已有的播放列表。不同任务的存储路径也要区分开。
控制台创建流程
- 在 StreamPackage 控制台的 Harvest Jobs 中选择 Create Harvest Job。
- 指定任务 ID 并选择 Origin endpoint。
- 在 Date and time format 中选择 Epoch seconds 或 ISO-8601。
- 指定开始与结束时刻。
- 确认 COS 权限并选择同地域的存储桶。
- 指定包含存储桶内部路径和父播放列表文件名的 Manifest key。
- 如需完成通知,请配置 Callback HTTP URL。
- 确认内容后创建任务。
任务 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 结果文件的删除需分别确认。删除测试产物时,请指定准确的存储桶 / 对象路径,并先确认是否存在共享。