流创建回调

流创建回调说明

描述

当开发者有维护直播列表的需求时,可以配置回调地址,LinkV-RtcServer 服务在流创建时,将会以 POST 的形式对回调地址进行请求。

回调说明

  • 请求方法: POST/JSON
  • 请求地址: http://127.0.0.1:8080/xxx/xxx?room_id=xxxx&user_id=xxxx&apply=1 注:客户可联系对接人员,进行自主配置

回调参数

参数类型说明
app_idstring账号ID
app_package_namestring包名
room_idstring房间ID
user_idstring上麦用户ID
applyint1.上麦 2.下麦
peer_list[]array房间在麦用户列表
room_idstringpeer:房间ID
user_idstringpeer:在麦用户ID
stream_idstringpeer:流ID
pull_urls[]stringpeer:cdn单流拉流地址

回调示例

{
    "app_id":"xxxxxx",
    "app_package_name":"xxxxxx",
    "room_id":"xxxxxx",
    "user_id":"xxxxxx",
    "apply":1,
    "peer_list":[
        {
            "room_id":"xxxxxx",
            "user_id":"xxxxxx",
            //单流vid拼接规则: s-{appid}-{roomid}-{userid}-{timestamp}
            //合流vid拼接规则: {roomid}
            "stream_id":"s-xxxxxx",
            "pull_urls":[
                "http://xxxxxx.linkv.fun/yolo/s-xxxxxx.flv"
            ]
        }
    ]
}

返回响应

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

重试策略

若请求回调地址出现 HTTP 失败(HTTP 状态码不为 2XX),LinkV-RtcServer 会在 1 秒后总共发起 3 次重试,重试仍然失败后,将不再继续重试。(重试策略可配置