更新时间:2026-10-19 14:43:09
流状态回调用于在推流开始或结束时,向您的服务发送 HTTP 请求。您可以通过回调更新应用中的直播状态,或触发监控等业务流程。
进入流媒体加速 > 互动直播 > 自助配置。
在域名列表中,找到需要配置的推流域名,然后选择配置修改。
在配置编辑器中,选择直播功能 > 流状态回调,然后选择添加。
如果域名已配置流状态回调,请修改现有配置行。
在流状态回调中,选择开启。
配置回调设置。
| 字段 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|
| 流状态回调 | 是 | 关闭 | 开启或关闭推流开始和结束事件的回调。 |
| 回调方法 | 是 | GET | 根据接收服务的要求,选择 GET 或 POST。 |
| 推流开始回调 URL | 是 | 无 | 填写接收推流开始通知的完整 URL,包括协议、域名或 IP 地址、可选端口和路径。 |
| 推流结束回调 URL | 是 | 无 | 填写接收推流结束通知的完整 URL,包括协议、域名或 IP 地址、可选端口和路径。 |
| 回调参数 | 否 | 见默认选项 | 选择随回调发送的参数,并按接收服务的要求修改参数名。 |
重要:开始地址和结束地址必须使用相同的协议和域名,例如
https://example.com/live/start和https://example.com/live/end。
回调 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 |
未选中 | 毫秒级事件时间戳。 |
| 自定义回调参数 | 空 | 可选 | 需要随回调发送的自定义参数。多个参数名使用英文分号 ; 分隔。 |