回调相关

日期: 2021-03-02

创盛视联数码科技（北京）有限公司

[TOC]

备注:

1. 视频转码回调，是以GET请求的方式通知到客户

2. 除了视频转码回调以为，其余均以POST JSON 请求的方式通知到客户

3. 回调相关的配置在CC账户 admin/云课堂/回调地址管理 进行设置

1.开始/结束直播回调

开始直播示例:
    {
      "roomid": "123",//房间ID
      "type": "start_live",//开始直播标识
      "liveid": "123",//直播ID
      "start_time": "2018-01-01 00:00:00",//直播开始时间
      "callback_data": ""//自定义回调参数,开始直播SDK传入的自定义参数
    }

结束直播示例:
    {
      "roomid": "123",//房间ID
      "type": "end_live",//开始直播标识
      "liveid": "123",//直播ID
      "start_time": "2018-01-01 00:00:00",//直播开始时间
      "end_time": "2018-01-01 00:00:00",//直播结束时间
      "callback_data": ""//自定义回调参数,开始直播SDK传入的自定义参数
    }
说明：
回调数据中type字段标识开始直播/结束直播, type为start_live为开始直播，type为end_live为结束直播    

2.登录/登出用户信息

登录示例:

{
  "exit": [

  ],
  "enter": [
    {
      "user_id": "ef19e1f2e05a42d8b7b6904b06c6d592",//登录用户ID
      "roomid": "318DE55001B6CEE39C33DC5901307461",// 房间ID
      "living_id": 85771,//直播场次ID
      "platform": "Android",//登录客户端类型 "ANDROID" / "IOS" / "WEB"
      "role": "presenter",//角色
      "username": "web老师",//用户名
      "enter_time": "2018-12-17 11:31:39",//登录时间
      "ip": "192.168.203.99"//登录IP
    }
  ]
}

登出示例:

{
    "enter": [

    ],
    "exit": [
        {
          "user_id": "49d6d8e68e19497abaf95769a76aafad",
          "roomid": "318DE55001B6CEE39C33DC5901307461",
          "living_id": 85771,
          "platform": "Web",
          "role": "talker",//角色
          "enter_time": "2018-12-14 10:24:50",
          "duration": 218.0,//持续时长以秒计算
          "exit_time": "2018-12-14 10:28:28",// 登出时间
          "username": "luo",
          "ip": "192.168.203.118"//登录IP
        }
    ]
}

说明:
role: 登录角色 讲师(presenter)/互动(talker)/旁听(audience)/(助教)assistant
platform: 终端 Android  Web  iOS

3.视频转码回调

参考点播文档:
https://doc.bokecc.com/vod/%E5%BC%80%E5%8F%91%E8%80%85%E8%B5%84%E6%BA%90/%E4%B8%8A%E4%BC%A0API/Flash%E8%A7%86%E9%A2%91%E4%B8%8A%E4%BC%A0/Flash%E8%A7%86%E9%A2%91%E4%B8%8A%E4%BC%A0.html

4.文档转码回调

转码成功
示例
    {"doc_id": "123", "convert_status": 1}

转码失败
示例
    {"doc_id": "123", "convert_status": 3}
说明:
    doc_id: 文档ID
    convert_status: 转码状态 1(成功) 3(失败)

5.录制回放回调

回调请求方式 POST
示例
    {
        "type": "separate",
        "roomid": "64BC9D6C0636FF049C33DC5901307461",
        "accountid": "88F5B1FCDE30281C",
        "liveid": "0E13C626B877A5CE",
        "status": 10
    }

说明:
    type: separate 普通分流; mp4_separate MP4之普通分流; mp4_full_separate MP4之全景分流; mp4_full_merge MP4之全景合流;
    roomid: 房间ID
    accountid: 账号ID
    liveid: 直播ID
    status: 录制结果状态 10(成功) 11(失败)