更新时间:2026-07-03 11:00:49
流状态汇报用于在互动直播推流开始和结束时,向您的外部服务发送实时回调。本指南介绍如何为直播推流域名开启流状态汇报、配置开始和结束汇报地址,以及选择随回调发送的汇报参数。
在域名配置编辑器中配置流状态汇报。
进入流媒体加速 > 互动直播 > 自助配置。
在域名列表中,找到需要配置的推流域名,然后选择配置修改。
在配置编辑器中,选择流状态汇报,然后选择添加。
如果未显示添加,该域名可能已存在流状态汇报配置。请检查现有的流状态汇报配置行。
在流状态汇报中,选择开启。
配置汇报设置。
| 字段 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|
| 流状态汇报 | 是 | 关闭 | 开启或关闭推流开始和结束事件的实时回调。可选值为 开启 和 关闭。 |
| 汇报方法 | 是 | GET | 发送回调请求时使用的 HTTP 方法。可选值为 GET 和 POST。 |
| 汇报地址(开始) | 是 | 无 | 接收推流开始事件的回调地址。请输入包含协议、域名或 IP、可选端口和 URI 的完整 URL。 |
| 汇报地址(结束) | 是 | 无 | 接收推流结束事件的回调地址。请输入包含协议、域名或 IP、可选端口和 URI 的完整 URL。 |
| 汇报参数 | 否 | 见默认选项 | 选择需要随回调发送的参数,并按外部服务要求修改参数名称。 |
重要:开始地址和结束地址必须使用相同的协议和域名。例如,两个地址都应使用同一个
https://example.com主机。
汇报地址应使用以下格式:
{协议头}://{host}:{端口}/{URI}
示例:
https://test.example.com/api/live/check
http://1.1.1.1:8888/api/live/check
您可以分别配置汇报开始和汇报结束需要发送的汇报参数。
汇报参数用于定义推流开始或结束时发送到回调地址的事件信息。对于每一种事件类型,您可以保留默认参数名,也可以按业务服务要求修改参数名。如果不需要发送某个参数,取消勾选即可。
| 参数 | 默认参数名 | 默认是否选中 | 说明 |
|---|---|---|---|
| 客户端ip | ip |
选中 | 触发流事件的客户端 IP 地址。 |
| CDN节点资源IP | node |
选中 | 处理该流事件的 CDN 节点资源 IP。 |
| 流名 | id |
选中 | 触发回调的流名称。 |
| HOST | host |
选中 | 与该流事件关联的 Host 值。 |
| 发布点 | appname |
选中 | 与该流关联的发布点或应用名称。 |
| MD5 | 无 | 未选中 | 选中后随回调发送的 MD5 值。 |
| 建联端口 | port |
选中 | 流连接使用的端口。 |
| 时间(s) | 无 | 选中 | 秒级事件时间戳。 |
| 时间(ms) | milltime |
未选中 | 毫秒级事件时间戳。 |
| 其他参数 | 无 | 可选 | 需要随回调发送的自定义参数名。多个参数使用英文分号 ; 分隔。 |