跳到内容

SSAI 验证与故障排查 ​

更新时间

开启容易,验证困难。

验证准备 ​

以下是流水线配置项。

项目方法结果
SSAI 配置生效DescribeStreamPackageChannelSSAIEnable = True,与配置值一致
Endpoint 播放请求主播放列表200
Rendition 分离主播放列表内容确认 720p / 1080p 两个
SCTE-35 透传DescribeStreamLiveChannelBehavior = 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-OUTCUE-IN备注
5 秒00尚未 —
10 秒10Marker 触发
35 秒70播放列表窗口全部为广告区间
70 秒61已过 SpliceDuration,区间结束
90 秒01Marker 从窗口消失

以 5400000(60 秒)传入 SpliceDuration,CUE-IN 落在 70 秒 附近。这说明 tick 换算正确。

广告插入验证 ​

虽然自行托管 ADS 并查看了访问日志,但来自 StreamPackage 的请求一条都没有。

目前已确认的情况如下。

既有测试的确认点

尝试了多种配置组合。

尝试结果
Google 公开 VAST 示例 URLADS 调用 —
自行托管的 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 600

2. 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 40901677

4. 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 -3
xml
<?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 状态期间会持续计费。

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