服务端 API v2
  • API概览
  • 快速开始
  • 调用方式
  • 房间信令接口
  • 混流接口
  • 媒体服务接口
  • 媒体文件接口
  • 音视频流审核接口
  • 场景服务接口
  • 回调说明
  • 全局返回码
  • 使用 Postman 调试

混流结束回调

更新时间:2022-11-28 17:31

1 描述

当开发者需要具体知道当前 App 的混流情况,可先配置回调。App 在混流服务器有混流结束时,将会以 POST 的形式对回调地址进行请求。

当出现如下情况:

  • 混流结束请求处理失败时,没有回调。
  • 混流过程中异常终止,没有回调。

2 回调说明

  • 请求方法:POST/FORM(表单值需要 urldecode 解码)。
  • 请求地址:请联系 ZEGO 技术支持配置回调地址。
  • 传输协议:HTTPS/HTTP,建议使用 HTTPS。

3 回调参数

参数 类型 描述
appid
Uint
APP 标识。
event
String
回调事件,此回调返回值为 mix_stop。
seq
Int
混流请求的序号,保证混流请求被执行的顺序,自增唯一。
task_id
String
混流 ID,如果混流开始请求中带上 task_id 参数,ZEGO 会加上 appid 前缀组成新的混流 ID,否则用 mix_url 等其他参数拼接混流 ID。
channel_id
String
频道 ID,对应客户端的 RoomID,不超过 255 字节。
publish_id
String
发布者 ID,对应客户端的 UserID,不超过 255 字节。
mix_url
String
混流最终输出的地址,RTMP 协议地址,不超过 255 字节。
mix_stream_alias
String
混流最终输出流名,不超过 255 字节。
timestamp
Int
服务器当前时间,Unix 时间戳。
nonce
String
随机数。
signature
String
检验串,请参考 回调说明 - 检验说明

4 数据示例

Array
(
    [appid] => 111111
    [event]  => mix_stop
    [seq]   => 1234
    [task_id] => aaa
    [channel_id] => 0xb-0x1
    [publish_id] => publish
    [mix_url] => mix_url
    [mix_stream_alias] => aaaa
    [timestamp] => 1481597358
    [nonce] => 158273
    [signature] => signature
)

5 返回响应

返回 HTTP status code 为 2XX (例如 200)表示成功,其他响应都表示失败。

6 回调重试策略

如果 ZEGO 服务器没有收到响应,会在 2s 后进行重试,共进行 5 次重试,且下一次重试与上一次重试间隔时间分别为 4s、8s、16s、32s。若第 5 次重试后,仍然失败,将不再重试,该回调丢失。