云直播回调

云直播回调,目前按照类型分为:直播会议回调、直播推流回调、直播互动回调、直播电话会议回调。回调内容以POST形式发送,并且内容格式设置为JSON,且支持Https。

注意:

  • 考虑到网络因素,回调信息可能存在无法到达的情况。此时系统会尝试重连(重连次数为3次)
  • 回调地址的配置和修改,请联系全时技术人员。

直播会议回调

1.1 会议开始

参数 类型 说明
method String 会议开始 meetingbegin
timestamp Long 时间戳
msgId String 消息ID
siteId Int 站点ID
customerCode String 客户编码
meetinginfo Json 消息体

meetinginfo 参数说明

参数 类型 说明
confId String 云会议ID
eventId String 直播会议ID
billingCode String 会议BC
hostId String 主持人ID
attendeeJoinUrl String 参会人链接
hostJoinUrl String 主持人链接

示例

{
    "method": "meetingbegin",
    "timestamp": 1648025135959,
    "msgId": "uniformserver-172.10.87.148-1648024077.80251320.928",
    "siteId": 0,
    "customerCode": "061548",
    "meetinginfo": {
        "confId": "239697078",
        "eventId": "556653",
        "billingCode": "95386465",
        "hostId": "88406965",
        "attendeeJoinUrl": "https://mtest.qsh1.cn/k/mkEPAQUu0X5",
        "hostJoinUrl": "https://mtest.qsh1.cn/k/mkEPAGRg2je"
    }
}

1.2 会议结束

参数 类型 说明
method String 会议结束 meetingend
timestamp Long 时间戳
msgId String 消息ID
siteId Int 站点ID
customerCode String 客户编码
meetinginfo Json 消息体

meetinginfo 参数说明

参数 类型 说明
confId String 云会议ID
eventId String 直播会议ID
billingCode String 会议BC
hostId String 主持人ID
attendeeJoinUrl String 参会人链接
hostJoinUrl String 主持人链接

示例

{
    "method": "meetingend",
    "timestamp": 1648025135959,
    "msgId": "uniformserver-172.10.87.148-1648025135.672827052.127",
    "siteId": 0,
    "customerCode": "061548",
    "meetinginfo": {
        "confId": "239697078",
        "eventId": "556653",
        "billingCode": "95386465",
        "hostId": "88406965",
        "attendeeJoinUrl": "https://mtest.qsh1.cn/k/mkEPAQUu0X5",
        "hostJoinUrl": "https://mtest.qsh1.cn/k/mkEPAGRg2je"
    }
}

1.3 会议更新

参数 类型 说明
method String 会议更新 update
timestamp Long 时间戳
msgId String 消息ID
siteId Int 站点ID
customerCode String 客户编码
event Json 消息体

event 参数说明

参数 类型 说明
id String 直播会议ID
title String 会议标题
summary String 会议简介
description String 描述信息
dtstart Long 开始时间
dtend Long 结束时间
location String 地点
status String 状态
siteId Int 站点ID
hostId String 主持人ID
importance Int 是否为重要会议,0:否,1:是
isGnet Int 是否使用云会议,0:不使用,1:使用
conferenceId String 云会议ID
hostPassword String 主持人密码
attendeePassword String 参会人密码
attendeeJoinUrl String 参会人链接
hostJoinUrl String 主持人链接
externalFlag String -
eventSource Int 活动来源 5: 云活动,6: 云课堂
eventManualService Int 是否需要项目经理开关,1:开启,2:关闭
eventForm Int 会议形式 1: 电话活动,3: 网络会议,4: 实时互动直播,7: 大型直播活动
liveScreen Int 云活动手机屏幕显示方式,0:横屏 1:竖屏
joinHostUrl String 助理主持人链接
parentEventId Long 母直播的eventId
billingCode String 云会议计费BC
room json 会议室信息
equip json 会议室设备信息

示例

{
    "method":"update",
    "timestamp":1672714108344,
    "msgId":"uniformserver-173707726-1672714107.958213748.84",
    "siteId":371741,
    "event":{
        "id":"1059346",
        "title":"test22211",
        "summary":"",
        "description":"",
        "dtstart":1672713000,
        "dtend":1672716600,
        "location":"",
        "status":"CONFIRMED",
        "siteId":371741,
        "hostId":"20735425",
        "importance":0,
        "isGnet":1,
        "conferenceId":"22089261",
        "hostPassword":"149292488147",
        "attendeePassword":"239472937454",
        "attendeeJoinUrl":"https://n.qsh1.cn/d/auR52qTTdH5",
        "hostJoinUrl":"https://n.qsh1.cn/d/auR52x7AkgN",
        "room":[
            {
                "roomId":282162,
                "roomName":"\"test\"",
                "roomNote":"\"\"",
                "roomStatus":1
            },
            {
                "roomId":282163,
                "roomName":"\"test222\"",
                "roomNote":"\"\"",
                "roomStatus":1
            }
        ],
        "equip":[
            {
                "equipId":426588,
                "equipName":"\"etewrt\"",
                "equipNote":"\"\"",
                "equipStatus":1
            },
            {
                "equipId":426589,
                "equipName":"\"234235\"",
                "equipNote":"\"\"",
                "equipStatus":1
            }
        ],
        "addRoomList":[
            {
                "roomId":282162,
                "roomName":"test",
                "roomNote":"",
                "roomStatus":0
            }
        ],
        "nochangeRoomList":[
            {
                "roomId":282163,
                "roomName":"test222",
                "roomNote":"",
                "roomStatus":0
            }
        ],
        "addEquipList":[
            {
                "equipId":426588,
                "equipName":"etewrt",
                "equipNote":"",
                "equipStatus":0
            }
        ],
        "nochangeEquipList":[
            {
                "equipId":426589,
                "equipName":"",
                "equipNote":"",
                "equipStatus":0
            }
        ],
        "externalFlag":"",
        "eventSource":5,
        "eventManualService":2,
        "eventForm":3,
        "liveScreen":0,
        "joinHostUrl":"https://s.qsh1.cn/a/OVLpyVE002BF",
        "parentEventId":0,
        "billingCode":"39960988",
        "calExtraInfo":{
            "L_s_public":1,
            "allowH323":1,
            "isTest":0,
            "labels":[

            ],
            "liveLag":1,
            "liveOpenFlag":1,
            "rebroadcast":1
        }
    },
    "customerCode":"026056"
}

1.4 会议取消

参数 类型 说明
method String 会议取消 cancel
timestamp Long 时间戳
msgId String 消息ID
siteId Int 站点ID
customerCode String 客户编码
event Json 消息体

event 参数说明

参数 类型 说明
id String 直播会议ID
title String 会议主题
summary String 会议简介
description String 描述信息
dtstart Long 开始时间
dtend Long 结束时间
location String 地点
status String 状态
siteId Int 站点ID
hostId String 主持人ID
importance Int 是否为重要会议,0:否,1:是
isGnet Int 是否使用云会议,0:不使用,1:使用
externalFlag String -
eventSource Int 活动来源 5: 云活动,6: 云课堂
eventManualService Int 是否需要项目经理开关,1:开启,2:关闭
eventForm Int 会议形式 1: 电话活动,3: 网络会议,4: 实时互动直播,7: 大型直播活动
liveScreen Int 云活动手机屏幕显示方式,0:横屏 1:竖屏
joinHostUrl String 助理主持人链接
parentEventId Long 母直播的eventId
billingCode String 云会议计费BC
room json 会议室信息
equip json 会议室设备信息

示例

{
    "method": "cancel",
    "timestamp": 1648619297857,
    "msgId": "uniformserver-172.10.57.228-1648619296.86321060.626",
    "siteId": 0,
    "customerCode": "061548",
    "event": {
        "id": "557507",
        "title": "event--0330006",
        "summary": "openapi%20%E6%B5%8B%E8%AF%95%E4%BC%9A%E8%AE%AE....",
        "description": "",
        "dtstart": 1648626240,
        "dtend": 1648633440,
        "location": "",
        "status": "CANCELLED",
        "siteId": 0,
        "hostId": "88406965",
        "importance": 0,
        "isGnet": 1,
        "externalFlag": "",
        "eventSource": 5,
        "eventManualService": 2,
        "eventForm": 7,
        "liveScreen": 0,
        "joinHostUrl": "http://stest.qsh1.cn/a/GRWXEX834021",
        "parentEventId": 0,
        "billingCode": ""
    }
}

1.5 会议录制

参数 类型 说明
method String 会议录制 record
timestamp Long 时间戳
msgId String 消息ID
siteId Int 站点ID
customerCode String 客户编码
record Json 消息体

record 参数说明

参数 类型 说明
confId String 云会议ID
eventId String 直播会议ID
videoURL String 录制文件(MP4格式)下载地址
thumbnail String 缩略图原始数据
operatorId String 会议主持人ID
videoLength Int 录制文件时长
videoSize Long 录制文件大小
attendeeJoinUrl String 参会人链接
hostJoinUrl String 主持人链接

示例

{
    "method": "record",
    "timestamp": 1648025454077,
    "msgId": "uniformserver-172.10.87.148-1648025453.995660211.939",
    "siteId": 0,
    "customerCode": "061548",
    "record": {
        "confId": "239697078",
        "eventId": "556653",
        "videoURL": "http://ltest.qsh1.cn/liveserver/live/url?c=24722&p=netease&t=download&u=http%3A%2F%2Fvods5sp6zek.nosdn.127.net%2F5fc9610361994b4f9c578735ce700279_1648024845648_1648025148456_5494895731-00000.mp4%3Fdownload%3D5fc9610361994b4f9c578735ce700279_20220323-164045_20220323-164548.mp4",
        "thumbnail": "",
        "operatorId": "88406965",
        "videoLength": 302,
        "videoSize": 2733721,
        "attendeeJoinUrl": "https://mtest.qsh1.cn/k/mkEPAQUu0X5",
        "hostJoinUrl": "https://mtest.qsh1.cn/k/mkEPAGRg2je"
    }
}

1.6 会议创建

参数 类型 说明
method String 会议邀请 invite
timestamp Long 时间戳
msgId String 消息ID
siteId Int 站点ID
customerCode String 客户编码
event Json 消息体

event 参数说明

参数 类型 说明
id String 直播会议ID
title String 会议标题
summary String 会议简介
description String 描述信息
dtstart Long 开始时间
dtend Long 结束时间
location String 地点
status String 状态
siteId Int 站点ID
hostId String 主持人ID
importance Int 是否为重要会议,0:否,1:是
isGnet Int 是否使用云会议,0:不使用,1:使用
conferenceId String 云会议ID
hostPassword String 主持人密码
attendeePassword String 参会人密码
attendeeJoinUrl String 参会人链接
hostJoinUrl String 主持人链接
externalFlag String -
eventSource Int 活动来源 5: 云活动,6: 云课堂
eventManualService Int 是否需要项目经理开关,1:开启,2:关闭
eventForm Int 会议形式 1: 电话活动,3: 网络会议,4: 实时互动直播,7: 大型直播活动
liveScreen Int 云活动手机屏幕显示方式,0:横屏 1:竖屏
joinHostUrl String 助理主持人链接
parentEventId Long 母直播的eventId
billingCode String 云会议计费BC
room json 会议室信息
equip json 会议室设备信息

示例

{
    "method": "invite",
    "timestamp": 1648619045264,
    "msgId": "uniformserver-172.10.57.228-1648619043.982133290.251",
    "siteId": 0,
    "customerCode": "061548",
    "event": {
        "id": "557507",
        "title": "event--0330006",
        "summary": "openapi 测试会议....",
        "description": "",
        "dtstart": 1648622642,
        "dtend": 1648629842,
        "location": "",
        "status": "CONFIRMED",
        "siteId": 0,
        "hostId": "88406965",
        "importance": 0,
        "isGnet": 1,
        "conferenceId": "239704234",
        "hostPassword": "201501000037412421",
        "attendeePassword": "201501000037412422",
        "attendeeJoinUrl": "https://mtest.qsh1.cn/k/mkGFF6KKrhR",
        "hostJoinUrl": "https://mtest.qsh1.cn/k/mkGFF6hrkDg",
        "externalFlag": "",
        "eventSource": 5,
        "eventManualService": 2,
        "eventForm": 7,
        "liveScreen": 0,
        "joinHostUrl": "http://stest.qsh1.cn/a/GRWXEX834021",
        "parentEventId": 0,
        "billingCode": "95387344"
    }
}

1.7 会议报告

参数 类型 说明
method String 会议报告 report
timestamp Long 时间戳
msgId String 消息ID
siteId Int 站点ID
customerCode String 客户编码
report Json 消息体

report 参数说明

参数 类型 说明
confId String 云会议ID
eventId String 直播会议ID
reportName String 报告名称
downloadUrl String 下载地址
attendeeJoinUrl String 参会人链接
hostJoinUrl String 主持人链接
hostId String 主持人ID

示例

{
    "method": "report",
    "timestamp": 1648025537844,
    "msgId": "uniformserver-172.10.87.148-1648025537.831650837.904",
    "siteId": 0,
    "customerCode": "061548",
    "report": {
        "confId": "239697078",
        "eventId": "556653",
        "reportName": "event--0323006",
        "downloadUrl": "http://uniformm.quanshi.com/confspace/report/download2/ce0e3ebfb342535a89a0307e92868cbf/pDOy6UymAlBj-yRz91oxMg/lX8JRDdgR35MfdmZUI86fg/239697078",
        "attendeeJoinUrl": "https://mtest.qsh1.cn/k/mkEPAQUu0X5",
        "hostJoinUrl": "https://mtest.qsh1.cn/k/mkEPAGRg2je",
        "hostId": "88406965"
    }
}

1.8 参会人入会

参数 类型 说明
method String 参会人入会 entermeeting
timestamp Long 时间戳
msgId String 消息ID
siteId Int 站点ID
customerCode String 客户编码
entermeeting Json 消息体

entermeeting 参数说明

参数 类型 说明
confId String 云会议ID
billingCode String 云会议BC
msgType Int 消息类型 4368: 用户下线; 4369: 用户上线; 130: 用户退会; 194: 强制退出(主持人踢人或强制结会)
hostId String 会议主持人ID
eventId String 直播会议ID
users Array 参会人信息

示例

{
    "method": "entermeeting",
    "timestamp": 1654670103965,
    "msgId": "10.90.153.62-1654670103.861228139.116",
    "siteId": 204642,
    "customerCode": "061548",
    "entermeeting": {
        "confId": "61759754",
        "billingCode": "8712632112",
        "msgType": 4369,
        "hostId": "651212321",
        "eventId": "606531",
        "users": [{
                "tempUserId": 861212,
                "userId": 12265,
                "name": "张三",
                "email": "",
                "mobile": ""
            }
        ]
    }
}

1.9 参会人离会

参数 类型 说明
method String 参会人离会 leavemeeting
timestamp Long 时间戳
msgId String 消息ID
siteId Int 站点ID
customerCode String 客户编码
leavemeeting Json 消息体

leavemeeting 参数说明

参数 类型 说明
confId String 云会议ID
billingCode String 云会议BC
msgType Int 消息类型 4368: 用户下线; 4369: 用户上线; 130: 用户退会; 194: 强制退出(主持人踢人或强制结会)
hostId String 会议主持人ID
eventId String 直播会议ID
users Array 参会人信息

示例

{
    "method": "leavemeeting",
    "timestamp": 1654670103965,
    "msgId": "10.90.153.62-1654670103.861228139.116",
    "customerCode": "061548",
    "siteId": 204642,
    "leavemeeting": {
        "confId": "61759754",
        "billingCode": "8712632112",
        "msgType": 194, //见上面消息类型说明
        "hostId": "651212321",
        "eventId": "606531",
        "users": [{
                "tempUserId": 861212,
                "userId": 12265,
                "name": "张三",
                "email": "",
                "mobile": ""
            }
        ]
    }
}

2.0 语音转文字

参数 类型 说明
method String 语音转文字 speachtotxtready
timestamp Long 时间戳
msgId String 消息ID
siteId Int 站点ID
customerCode String 客户编码
speachtxt Json 消息体

speachtxt 参数说明

参数 类型 说明
confId String 云会议ID
tempConferenceId String 临时会议ID
billingCode String 会议BC
hostId String 主持人ID
eventId String 直播会议ID
sttDownLoadUrl String 语音转文字后的文本下载地址

示例

{ 
    "method":"speachtotxtready", 
    "timestamp":1661305648971, 
    "msgId":"74097A40-5EDC-8CDC-8E46-732E1411FE9E", 
    "customerCode": "061548",
    "siteId":82851, 
    "speachtxt":{ 
        "confId":"22062882",
        "billingCode":"43845936", 
        "hostId":"12593106",
        "eventId": "606332",
        "tempConferenceId":"671399984", 
        "sttDownLoadUrl":"https://rackbeta.qsh1.cn/resources/20220824/671399984/downloadzip/def51434a5a4451fb364d42182cde84.txt" 
    }
}