文档中心
体验 AppSDK 中心API 中心常见问题代码市场
中文
中文 English
文档中心
体验 App
SDK 中心
API 中心
常见问题
代码市场
进入控制台
立即注册
登录控制台
中文站 English
服务端 API

服务端API

  • 服务端 API v2
  • 服务端 API
展开所有目录
  • 后台接入说明
  • 后台回调说明
  • 后台混流接口
  • 服务端录制接口
  • 后台房间信令接口
  • 音频审核接口
  • 媒体服务接口
  • 文档中心
  • 服务端 API
  • 后台回调说明
  • 流创建回调说明

流创建回调说明

更新时间：2023-09-15 17:40

1 使用场景

若业务方有维护直播列表的需求。

当 APP 在流媒体服务器有流创建时，将会以 POST 的形式对回调地址进行请求。

2 请求参数

HTTP 请求方式: POST/FORM 或 JSON（表单值需要 urldecode 解码）新接入的客户默认回调为 JSON 格式。
地址： 客户可到 ZEGO 控制台 进行自主配置。

参数名 类型 说明
stream_sid String 流server ID, 流唯一标识，zego后台生成，客户不用关注
channel_id String 频道ID 对应客户端RoomID 不超过127字节
title String 标题 不超过255字节
stream_alias String 流名 对应客户端StreamID 不超过255字节
publish_id String 发布者ID 对应客户端UserID 不超过255字节
publish_name String 发布者名字 对应客户端UserName 不超过255字节
rtmp_url Array RTMP拉流地址 不超过1024字节
hls_url Array HLS拉流地址 不超过1024字节
hdl_url Array HDL拉流地址 不超过1024字节
pic_url Array 截图地址 不超过255字节
create_time String 创建时间（Unix时间戳）
timestamp String 服务器当前时间（Unix时间戳）
nonce String 随机数
signature String 检验串，详细见检验说明
extra_info string 流附加信息
appid String appid
event String 事件名称:stream_create
stream_id String 流id, 对应客户端StreamID,跟stream_alias的意义一样
stream_seq String 服务器流列表变更的seq，每次流变更都会加1
room_id String 房间id，对应客户端RoomID，跟channel_id的意义一样，不超过127字节
recreate String 是否重复推流，recreate=="1"表示客户端重新推了一条服务器已存在的流，recreate=="0"表示新流
user_id String 用户id，跟publish_id的意义一样，不超过255字节
user_name String 用户昵称，跟publish_name 的意义一样，不超过255字节

3 数据示例

    Array
    (
        [stream_sid] => s-115205137699740000000000104
        [channel_id] => 0xb-0x1
        [stream_alias] => aaaa
        [title] => tile
        [rtmp_url] => Array
            (
                [0] => rtmp://rtmp.wsdemo.zego.im/zegodemo/aaa
                [1] => rtmp://testplay.aliyun.zego.im/livestream/aaa
            )

        [hls_url] => Array
            (
                [0] => http://hls.wsdemo.zego.im/zegodemo/aaa/playlist.m3u8
                [1] => http://testplay.aliyun.zego.im/livestream/aaa.m3u8
            )

        [hdl_url] => Array
            (
                [0] => http://hdl.wsdemo.zego.im/zegodemo/aaa.flv
                [1] => http://testplay.aliyun.zego.im/livestream/aaa.flv
            )

        [pic_url] => Array
            (
                [0] => http://pic.wsdemo.zego.im/zegodemo/aaa.jpg
            )

        [publish_id] => publish
        [publish_name] => name
        [create_time] => 1481597358
        [timestamp] => 1481597358
        [nonce] => 158273
        [signature] => signature
        [extra_info] => "extra"
        [appid] => 1
        [event] => stream_create
    )

4 返回响应

1

应答为1表示成功，其余都为失败。

5 回调重试策略

如果 ZEGO 服务器没有收到响应，会在 15 秒后发起重试，最多重试两次。

本篇目录
  • 免费试用

  • 联系我们