跳到内容

通过 Plan 注入 SCTE-35 ​

更新时间

说到插入 SCTE-35 标记,通常首先会想到编码器。但在测试或演示场景下,连编码器一起改动比较麻烦。StreamLive 提供了名为 Plan 的预约事件资源,在此使用 SCTE35_SPLICE_INSERT 类型,无需编码器即可直接推送标记。

请求示例 ​

假设要在当前正在运行的直播频道中插入一个时长为 60 秒 的广告时段。

bash
cat > /tmp/plan.json <<'EOF'
{"EventName":"justinkim_ad_break_001",
 "TimingSettings":{"StartType":"IMMEDIATE"},
 "EventSettings":{"EventType":"SCTE35_SPLICE_INSERT",
                  "SpliceEventID":909001,
                  "SpliceDuration":"5400000"}}
EOF

tccli mdl CreateStreamLivePlan --region ap-seoul \
  --ChannelId 6941****5240 \
  --Plan "$(cat /tmp/plan.json)"

创建 Plan 的瞬间,标记就会进入频道。约 10 秒 后查看媒体播放列表,输出示例如下。

text
#EXT-X-CUE-OUT-CONT:ElapsedTime=8.2,Duration=60,SCTE35=/AAgAAGuKZt0AAAADwUADd7KAPCAAFJlwAAAAAAAANYfkZ8=
#EXT-X-PROGRAM-DATE-TIME:2026-09-14T06:29:22.361Z
#EXTINF:4.000, seq 40778661

60 秒 之后显示 #EXT-X-CUE-IN,广告时段结束。

SpliceDuration 计算 ​

SpliceDuration 的单位是 90kHz tick。若按秒来理解容易混淆。

text
tick = 秒 × 90000
广告时段tick 值
15 秒1350000
30 秒2700000
60 秒5400000
90 秒8100000

该值以字符串形式传递。

TimingSettings ​

StartType行为
IMMEDIATE创建 Plan 后立即执行
ABSOLUTE在 Time 指定的时间执行

IMMEDIATE 是一创建就立即触发。它不是“稍后开启”的概念,这一点一开始容易混淆。如果需要预约,请配合 ABSOLUTE 与 Time 一起使用。

json
{
  "StartType": "ABSOLUTE",
  "Time": "2026-09-15T12:00:00Z"
}

附加 Segmentation Descriptor ​

多数情况下仅使用默认的 splice_insert 即可,但如果广告系统要求 segmentation type,则需同时指定 SCTE35SegmentationDescriptor。

json
{
  "EventName": "justinkim_ad_break_002",
  "TimingSettings": {
    "StartType": "IMMEDIATE"
  },
  "EventSettings": {
    "EventType": "SCTE35_SPLICE_INSERT",
    "SpliceEventID": 909002,
    "SpliceDuration": "5400000",
    "SCTE35SegmentationDescriptor": [
      {
        "EventID": 909002,
        "EventCancelIndicator": 0,
        "Duration": 5400000,
        "UPIDType": 0,
        "UPID": "justinkim-ad-break-002",
        "TypeID": 52,
        "Num": 0,
        "Expected": 0,
        "SubSegmentNum": 0,
        "SubSegmentsExpected": 0
      }
    ]
  }
}

TypeID 的值为 SCTE-35 segmentation_type_id。

TypeID含义
48Provider Advertisement Start
49Distributor Advertisement Start
52Provider Placement Opportunity Start
53Distributor Placement Opportunity Start
54Break Start

AdTriggers 中填入的值必须与此 TypeID 相互匹配。请同时参考AdTriggers 值 表格进行选择。

EventType 类型 ​

EventType用途
SCTE35_SPLICE_INSERT进入广告时段(本文档的主角)
SCTE35_RETURN_TO_NETWORK结束广告时段
SCTE35_TIME_SIGNAL时间信号
TIMED_METADATA插入 ID3 元数据
ID3_SEGMENT_TAGGING按分片打标
INPUT_SWITCH输入切换
TIMED_RECORD时段录制

仅用 SCTE35_SPLICE_INSERT 一个即可同时处理进入与结束。SpliceDuration 结束后会自动发出 CUE-IN。

Plan 管理 ​

Plan API 提供创建 / 查询 / 删除能力。

bash
# 列表
tccli mdl DescribeStreamLivePlans --region ap-seoul --ChannelId 6941****5240

# 删除
tccli mdl DeleteStreamLivePlan --region ap-seoul \
  --ChannelId 6941****5240 --EventName justinkim_ad_break_001

IMMEDIATE Plan 在创建后立即执行。测试结束后请清理执行记录。

确认方法 ​

要确认标记是否真正发出,最快的方法是查看媒体播放列表。

bash
curl -s "https://<endpoint>/<rendition>.m3u8" | grep -E "CUE-OUT|CUE-IN"

标记执行后确认 #EXT-X-CUE-OUT-CONT,指定时段结束后确认 #EXT-X-CUE-IN。请以短于播放列表保留时长的间隔进行查询。

注意事项 ​

SpliceDuration 的单位是 90kHz tick。60 秒 通过 60 × 90000 = 5400000 指定。

Plan 仅适用于处于 RUNNING 状态的 StreamLive 频道。

SpliceEventID 是 32 位的唯一值。反复测试时,最好每次都更换 ID,这样更安全。

后续步骤 ​

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