事件通知回调

直播服务的事件通知使用统一数据格式回调,不同事件通过不同的eventType进行区分 格式如下:

{
    "eventType": "xxxxx",
    "eventData": { ... }
}

开始推流回调

请求路径:传入的url

请求方式:POST

参数要求:

名称 类型 是否必需 描述
eventType String 事件类型
eventData Object 事件数据
├─liveId String 直播间ID
├─liveName String 直播间名字
├─time String 开始时间

返回数据:

{
    "eventType": "live_start",
    "eventData": {
        "liveId":"live-123456789",
        "liveName":"测试课程001",
        "time":"2020-05-08 17:34:23"
    }
}

结束推流回调

请求路径:传入的url

请求方式:POST

参数要求:

名称 类型 是否必需 描述
eventType String 事件类型
eventData Object 事件数据
├─liveId String 直播间ID
├─liveName String 直播间名字
├─time String 开始时间

返回数据:

{
    "eventType": "live_end",
    "eventData": {
        "liveId":"live-123456789",
        "liveName":"测试课程001",
        "time":"2020-05-08 17:34:23"
    }
}

直播回放回调

在直播课结束后,抱石云会自动生成本次直播的回放视频,生成成功后会以主动通知的方式回调调用方地址,调用方地址在创建直播间时传入。

请求路径:传入的url

请求方式:POST

参数要求:

名称 类型 是否必需 描述
eventType String 事件类型
eventData Object 事件数据
├─mediaId String 媒资ID
├─liveId String 直播间ID
├─ title String 直播间名字
├─ status String 状态
├─ metaInfo Object 回放信息
├─├─ bsyVodMediaInfo Object 回放视频信息
├─├─├─ duration String 时长
├─├─├─ image String 封面图

返回数据:

{
    "eventType":"live_record",
    "eventData":{
        "mediaId":"media-843744832487424",
        "liveId":"live-843744832454656",
        "title":"测试回放兼容",
        "status":"SUCCESSFUL",
        "metaInfo":{
            "bsyVodMediaInfo":{
                "duration":"480.146445",
                "image":"https://test-hky-video.kaikeba.com/resource/media-843744832487424/586889763512422896a1fbb1c0c5f67e_00001.jpg"
            }
        },
        "vodType":"bsy"
    }
}

用户登录退出回调

在直播过程中发送用户登录/退出回调通知。

请求路径:传入的url

请求方式:POST

参数要求:

名称 类型 是否必需 描述
eventType String 固定值,“live_user_login_out”
eventData Object 事件数据
├─ liveId String 直播间ID
├─ uid String 用户ID
├─ sid String sessionID
├─ nickname String 昵称
├─ userRole int 1 讲师 2 助教 3 班主任 999 学生
├─ deviceType String 设备类型 Android iOS H5 Web unknown
├─ clientIp String 客户端IP
├─ networkType String 客户端网络类型
├─ action String login 进入 login-out 退出
├─ time String 对应动作的时间

返回数据:

{
    "eventType": "live_user_login_out",
    "eventData": {
        "liveId": "live-852540175515648",
        "uid": "57521782",
        "sid": "2f14b5d98039e1744a2870df3a675f33",
        "nickname": "张三",
        "userRole": 999,
        "deviceType": "iOS",
        "clientIp": "123.57.104.71",
        "networkType": "Wi-Fi",
        "action": "login",
        "time": "2021-07-23 15:06:11"
    }
}

结束上课回调

主要用于通知业务侧课程状态

请求路径:传入的url

请求方式:POST

参数要求:

名称 类型 是否必需 描述
eventType String 事件类型
eventData Object 事件数据
├─liveId String 直播间ID
├─liveName String 直播间名字
├─time String 开始时间

返回数据:

{
    "eventType": "live_biz_end",
    "eventData": {
        "liveId":"live-123456789",
        "liveName":"测试课程001",
        "time":"2020-05-08 17:34:23"
    }
}

results matching ""

    No results matching ""