通过 Plan 注入 SCTE-35
说到插入 SCTE-35 标记,通常首先会想到编码器。但在测试或演示场景下,连编码器一起改动比较麻烦。StreamLive 提供了名为 Plan 的预约事件资源,在此使用 SCTE35_SPLICE_INSERT 类型,无需编码器即可直接推送标记。
请求示例
假设要在当前正在运行的直播频道中插入一个时长为 60 秒 的广告时段。
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 秒 后查看媒体播放列表,输出示例如下。
#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 4077866160 秒 之后显示 #EXT-X-CUE-IN,广告时段结束。
SpliceDuration 计算
SpliceDuration 的单位是 90kHz tick。若按秒来理解容易混淆。
tick = 秒 × 90000| 广告时段 | tick 值 |
|---|---|
15 秒 | 1350000 |
30 秒 | 2700000 |
60 秒 | 5400000 |
90 秒 | 8100000 |
该值以字符串形式传递。
TimingSettings
| StartType | 行为 |
|---|---|
IMMEDIATE | 创建 Plan 后立即执行 |
ABSOLUTE | 在 Time 指定的时间执行 |
IMMEDIATE 是一创建就立即触发。它不是“稍后开启”的概念,这一点一开始容易混淆。如果需要预约,请配合 ABSOLUTE 与 Time 一起使用。
{
"StartType": "ABSOLUTE",
"Time": "2026-09-15T12:00:00Z"
}附加 Segmentation Descriptor
多数情况下仅使用默认的 splice_insert 即可,但如果广告系统要求 segmentation type,则需同时指定 SCTE35SegmentationDescriptor。
{
"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 | 含义 |
|---|---|
48 | Provider Advertisement Start |
49 | Distributor Advertisement Start |
52 | Provider Placement Opportunity Start |
53 | Distributor Placement Opportunity Start |
54 | Break 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 提供创建 / 查询 / 删除能力。
# 列表
tccli mdl DescribeStreamLivePlans --region ap-seoul --ChannelId 6941****5240
# 删除
tccli mdl DeleteStreamLivePlan --region ap-seoul \
--ChannelId 6941****5240 --EventName justinkim_ad_break_001IMMEDIATE Plan 在创建后立即执行。测试结束后请清理执行记录。
确认方法
要确认标记是否真正发出,最快的方法是查看媒体播放列表。
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,这样更安全。