流状态汇报

更新时间:2026-10-19 14:43:09

流状态回调用于在推流开始或结束时,向您的服务发送 HTTP 请求。您可以通过回调更新应用中的直播状态,或触发监控等业务流程。

开始之前

  • 您拥有在 CDNetworks 控制台配置目标推流域名的权限。
  • 您的服务已准备好可访问的推流开始和结束回调地址,两个地址须使用相同的协议和域名。
  • 您已确认服务所需的 HTTP 方法和回调参数。

配置流状态回调

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

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

  3. 在配置编辑器中,选择直播功能 > 流状态回调,然后选择添加。

    如果域名已配置流状态回调,请修改现有配置行。

  4. 在流状态回调中,选择开启。

  5. 配置回调设置。

字段 是否必填 默认值 说明
流状态回调 是 关闭 开启或关闭推流开始和结束事件的回调。
回调方法 是 GET 根据接收服务的要求,选择 GET 或 POST。
推流开始回调 URL 是 无 填写接收推流开始通知的完整 URL,包括协议、域名或 IP 地址、可选端口和路径。
推流结束回调 URL 是 无 填写接收推流结束通知的完整 URL,包括协议、域名或 IP 地址、可选端口和路径。
回调参数 否 见默认选项 选择随回调发送的参数,并按接收服务的要求修改参数名。

重要:开始地址和结束地址必须使用相同的协议和域名,例如 https://example.com/live/start 和 https://example.com/live/end。

  1. 在回调参数中,展开点击配置。在推流开始参数和推流结束参数中,分别选择对应事件需要发送的参数。
  2. 选择确认并检查配置内容。选择保存草稿将配置保存为草稿,或选择下一步继续域名配置流程。

参考信息

回调 URL 格式

回调 URL 应使用以下格式:

{协议}://{主机}[:{端口}]/{路径}

端口为可选项,例如:

https://example.com/live/start
http://192.0.2.10:8888/live/start

回调参数

您可以分别为推流开始参数和推流结束参数选择参数。参数名可使用预填值,也可按接收服务的要求填写。表中的“空”表示未预填参数名。不需要发送的参数,取消勾选即可。

参数 默认参数名 默认是否选中 说明
推流客户端 IP ip 选中 推流客户端的 IP 地址。
CDN 接入节点 IP node 选中 处理该直播流的 CDN 接入节点 IP 地址。
流名 id 选中 该事件对应的流名称。
Host app 选中 与该流事件关联的 Host 值。
发布点 appname 选中 该直播流对应的发布点名称。
MD5 空 未选中 选中后随回调发送的 MD5 值。
推流连接端口 port 选中 推流连接使用的端口。
事件时间戳(秒) 空 选中 秒级事件时间戳。
事件时间戳(毫秒) milltime 未选中 毫秒级事件时间戳。
自定义回调参数 空 可选 需要随回调发送的自定义参数。多个参数名使用英文分号 ; 分隔。
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!