SSAI 验证与故障排查
开启容易,验证困难。
验证准备
以下是流水线配置项。
| 项目 | 方法 | 结果 |
|---|---|---|
| SSAI 配置生效 | DescribeStreamPackageChannel | SSAIEnable = True,与配置值一致 |
| Endpoint 播放 | 请求主播放列表 | 200 |
| Rendition 分离 | 主播放列表内容 | 确认 720p / 1080p 两个 |
| SCTE-35 透传 | DescribeStreamLiveChannel | Behavior = PASSTHROUGH |
| Marker 注入(Plan) | CreateStreamLivePlan | 出现 EXT-X-CUE-OUT,60 秒 后出现 EXT-X-CUE-IN |
| PDT 插入 | 媒体播放列表 | 确认 EXT-X-PROGRAM-DATE-TIME |
| 经由 CDN | 通过域名请求 | 200 |
以下是通过 Plan 注入的 Marker 的实测值。以 5 秒 的间隔轮询媒体播放列表。
| 时间 | CUE-OUT | CUE-IN | 备注 |
|---|---|---|---|
5 秒 | 0 | 0 | 尚未 — |
10 秒 | 1 | 0 | Marker 触发 |
35 秒 | 7 | 0 | 播放列表窗口全部为广告区间 |
70 秒 | 6 | 1 | 已过 SpliceDuration,区间结束 |
90 秒 | 0 | 1 | Marker 从窗口消失 |
以 5400000(60 秒)传入 SpliceDuration,CUE-IN 落在 70 秒 附近。这说明 tick 换算正确。
广告插入验证
虽然自行托管 ADS 并查看了访问日志,但来自 StreamPackage 的请求一条都没有。
目前已确认的情况如下。
尝试了多种配置组合。
| 尝试 | 结果 |
|---|---|
| Google 公开 VAST 示例 URL | ADS 调用 — |
自行托管的 VAST(work.) | ADS 调用 — |
AdTriggers [1] / [1,2,4,5] | 相同 |
添加 Segmentation Descriptor TypeID=52 | 相同 |
TimeShiftEnable = True | 相同 |
| 新建 Endpoint 并应用 | 相同 |
验证广告插入前,请先在控制台确认账号的 SSAI 使用设置,并比对 ADS 请求日志与实际播放。
若还需要验证广告插入,请先在控制台确认 SSAI 的使用申请状态。
验证步骤
text
1. 获取标记来源 StreamLive Plan 或 SCTE-35 编码器
2. 确认 StreamLive 透传 Behavior = PASSTHROUGH,播放列表中出现 CUE-OUT
3. StreamPackage 配置 SSAIEnable = True
4. 确认 ADS 响应 查看 ADS 访问日志中是否有请求记录
5. 确认播放 查看广告时段是否正常播出广告在 ADS 服务器日志中确认广告请求 / 响应。外部 ADS 请使用提供商的日志或诊断功能。
1. StreamLive SCTE-35
bash
tccli mdl DescribeStreamLiveChannel --region ap-seoul --Id 6AA6****5542 \
| python3 -c "
import sys,json
d=json.load(sys.stdin)['Info']
for g in d['OutputGroups']:
for o in g['Outputs']:
print(o['Name'], o['Scte35Settings'])
print('PDT:', g['HlsRemuxSettings']['PdtInsertion'], g['HlsRemuxSettings']['PdtDuration'])
"预期结果如下。
text
justinkimout1080p {'Behavior': 'PASSTHROUGH'}
justinkimout720p {'Behavior': 'PASSTHROUGH'}
PDT: OPEN 6002. StreamPackage SSAI
bash
tccli mdp DescribeStreamPackageChannel --region ap-seoul --Id 6AA6****32BF \
| python3 -c "
import sys,json
for e in json.load(sys.stdin)['Info']['Points']['Endpoints']:
print(e['Name'], 'SSAIEnable =', e.get('SSAIEnable'))
"3. PDT 标签
bash
curl -s "https://cdn." | head -8预期结果如下。
text
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA-SEQUENCE:40901677
#EXT-X-TARGETDURATION:4
#EXT-X-PROGRAM-DATE-TIME:2026-09-14T05:42:45.388Z
#EXTINF:4.000, seq 409016774. ADS 响应
VAST 标签本身按以下方式确认。
bash
curl -s -o /dev/null -w "%{http_code}\n" "https://ads.example.com/vast?cid=****"
curl -s "https://ads.example.com/vast?cid=****" | head -3xml
<?xml version="1.0" encoding="UTF-8"?><VAST version="3.0"><Ad id="...">bash
# 自行托管 ADS 时
sudo grep 'vast.xml' /var/log/nginx/access.log比对 ADS 请求日志与播放列表 Marker 的时间点,确认广告插入区间。
自行制作 VAST 时,最少需要以下内容。
xml
<?xml version="1.0" encoding="UTF-8"?><VAST version="3.0"><Ad id="ad-001">
<InLine>
<AdSystem>test</AdSystem>
<AdTitle>Test Ad</AdTitle>
<Creatives>
<Creative id="c1" sequence="1">
<Linear>
<Duration>00:01:00</Duration>
<MediaFiles>
<MediaFile delivery="progressive" type="video/mp4"
bitrate="500" width="1280" height="720">
<![CDATA[https://example.com/ad.mp4]]>
</MediaFile>
</MediaFiles>
</Linear>
</Creative>
</Creatives>
</InLine></Ad></VAST>建议让 Duration 与广告时长(SpliceDuration)保持一致,并让 MP4 与正片的分辨率保持一致。
故障排查
| 现象 | 原因 | 处理 |
|---|---|---|
| Marker 未出现在流中 — | 编码器未发送 | 通过 Plan 注入,先只确认 Marker 区间 |
| Marker 未出现在流中 — | SpliceDuration 以秒为单位传入 | 换算为 tick(秒 × 90000) |
| Marker 有但广告 — | AdTriggers 中没有对应类型 | 确认触发值 |
| Marker 有但广告 — | DeliveryRestrictions 不一致 | 尝试放宽为 4(Both) |
| Marker 有但 ADS 日志为空 | 账号未开通 SSAI(很可能) | 在控制台确认 SSAI 使用申请 |
| 广告替换区间 | ADS 响应 | 检查 ADS URL 与响应 |
| 广告替换区间 | 垫播片 | 检查 SlateAd URL 可访问性 |
| 广告插在错误位置 | PDT 已关闭 | PdtInsertion = OPEN |
| 广告区间播放卡顿 | 垫播片分辨率不一致 | 统一分辨率与帧率 |
| Marker 消失 | StreamLive 未放行 | Behavior = PASSTHROUGH |
| 完全无法播放 | CDN 域名问题 | 参考 CDN 文档 |
注意事项
调用 Modify 后,用 Describe 确认已生效的配置。
删除 StreamPackage 频道后重建,Endpoint URL 的哈希会发生变化。如果在文档或 App 中硬编码了播放地址,将全部失效。删除测试用频道时请注意。
测试后清理
bash
# 停止 StreamLive 频道
tccli mdl StopStreamLiveChannel --region ap-seoul --Id 6AA6****5542
# 停止 StreamLink Flow
tccli mdc StopStreamLinkFlow --region ap-seoul --FlowId 82iv****74eg处于 RUNNING 状态期间会持续计费。