流状态汇报

更新时间:2026-07-03 11:00:49

流状态汇报用于在互动直播推流开始和结束时,向您的外部服务发送实时回调。本指南介绍如何为直播推流域名开启流状态汇报、配置开始和结束汇报地址,以及选择随回调发送的汇报参数。

开始之前

  • 您已拥有可配置目标互动直播域名的 CDNetworks 控制台账号权限。
  • 您要配置的是推流域名,因为流状态汇报用于推流开始和结束事件。
  • 您已准备可访问的推流开始汇报地址和推流结束汇报地址。
  • 推流开始汇报地址和推流结束汇报地址使用相同的协议和域名。
  • 您已确认外部服务需要接收哪些汇报参数。

配置流状态汇报

在域名配置编辑器中配置流状态汇报。

  1. 进入流媒体加速 > 互动直播 > 自助配置

  2. 在域名列表中,找到需要配置的推流域名,然后选择配置修改

  3. 在配置编辑器中,选择流状态汇报,然后选择添加

    如果未显示添加,该域名可能已存在流状态汇报配置。请检查现有的流状态汇报配置行。

  4. 流状态汇报中,选择开启

  5. 配置汇报设置。

字段 是否必填 默认值 说明
流状态汇报 关闭 开启或关闭推流开始和结束事件的实时回调。可选值为 开启关闭
汇报方法 GET 发送回调请求时使用的 HTTP 方法。可选值为 GETPOST
汇报地址(开始) 接收推流开始事件的回调地址。请输入包含协议、域名或 IP、可选端口和 URI 的完整 URL。
汇报地址(结束) 接收推流结束事件的回调地址。请输入包含协议、域名或 IP、可选端口和 URI 的完整 URL。
汇报参数 见默认选项 选择需要随回调发送的参数,并按外部服务要求修改参数名称。

重要:开始地址和结束地址必须使用相同的协议和域名。例如,两个地址都应使用同一个 https://example.com 主机。

  1. 汇报参数中,展开点击配置。在汇报开始汇报结束中,分别选择推流开始和推流结束回调需要发送的参数。
  2. 选择确认,在编辑器中检查流状态汇报配置行,然后仅当您准备进入完整域名配置复核时,选择下一步

参考信息

汇报地址格式

汇报地址应使用以下格式:

{协议头}://{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 未选中 毫秒级事件时间戳。
其他参数 可选 需要随回调发送的自定义参数名。多个参数使用英文分号 ; 分隔。
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!