事件类型

event_type	事件含义
300	云端录制完成抄送
301	云端录制服务发生错误
302	云端录制服务状态发生变化
303	录制的音频流状态变化
304	录制的视频流状态变化
305	云端录制失败
3	录制文件下载信息

300 云端录制完成抄送

云端录制完成时，会触发此抄送。

当录制文件生成完毕，并且上传到点播系统后，会触发3 录制文件下载信息抄送。

字段说明

字段	类型	示例	说明
eventType	Number	300	事件类型
data	JSON 数组	-	抄送消息体。

data 结构的字段说明：

字段	类型	示例	说明
channelId	Number	43357868525520	被录制的房间 ID。
channelName	String	qaz	被录制的房间名称。
timestamp	Number	1607001232517	该事件发生的 Unix 时间戳，单位为毫秒（ms）。
detail	JSON	-	具体的消息内容，JSON 类型，详细字段请查看下表。

detail 字段说明：

detail 字段	类型	示例	说明
uid	Number	892576	用户 ID。
aDiscardRate	Number	0	录制服务音频丢包比例。
vDiscardRate	Number	0	录制服务视频丢包比例。
aFirstTs	Number	20	第一个音频包原始时间戳。
vFirstTs	Number	0	第一个视频包原始时间戳。
logoutTime	Number	0	用户总退出时间。
largestW	Number	720	最大分辨率宽。
largestH	Number	1280	最大分辨率高。
aPkt	Number	129	网络音频收包数。
vPkt	Number	667	网络视频收包数。
vTotal	Number	78	视频帧总数。
vDisorder	Number	0	乱序视频帧数。
vError	Number	0	错误视频帧数。
vLost	Number	0	视频丢帧数。
vDump	Number	78	视频落盘帧数。
vDecError	Number	0	视频解码失败帧数。
aTotal	Number	102	总音频包数。
aDisorder	Number	0	乱序音频包数。
aLost	Number	0	音频丢包数。
aDump	Number	102	音频落盘包数。
aDecError	Number	0	音频解码失败数。
dumpDisorder	Number	0	落盘乱序包数。
avDelay	Number	1	音视频不同步的包的数量。
tsFixed	Number	0	修正时间戳包数。

JSON 示例

json{
    "data":{
        "channelName":"qaz",
        "detail":[
            {
                "aFirstTs":20,
                "vTotal":78,
                "aDecError":0,
                "aDump":102,
                "largestW":720,
                "avDelay":1,
                "vDiscardRate":0,
                "tsFixed":0,
                "vDisorder":0,
                "vError":0,
                "aDiscardRate":0,
                "logoutTime":0,
                "uid":892576,
                "vFirstTs":0,
                "largestH":1280,
                "aPkt":129,
                "vDump":78,
                "vPkt":667,
                "dumpDisorder":0,
                "vLost":0,
                "aDisorder":0,
                "aTotal":102,
                "aLost":0,
                "vDecError":0
            }
        ],
        "channelId":43357868525520,
        "timestamp":1607001232517
    },
    "eventType":300
}

301 云端录制服务发生错误

云端录制过程中，如果发生错误，将会触发此抄送。

字段说明

字段	类型	示例	说明
eventType	Number	301	事件类型
data	JSON 数组	-	抄送消息体。

data 结构的字段说明：

字段	类型	示例	说明
errorLevel	Number	1	错误级别。包括： 1：debug。 2：minor。 3：medium。 4：major。 5：fatal。 fatal 级别的错误很可能导致录制退出，如果收到该级别的消息请及时调用服务端 API 查询云端录制文件信息 查询当前状态，并结合错误消息的内容进行处理。
errorCode	Number	1	错误码。1 表示 dump 文件写入失败。
channelName	String	10086	被录制的房间名称。
channelId	Number	43357244164048	被录制的房间 ID。
status	Number	0	云端录制状态码。详细说明请参考云端录制状态码。
timestamp	Number	1606984002551	该事件发生时的 Unix 时间戳，单位为毫秒（ms）。

JSON 示例

json{
    "data":{
        "errorLevel":"1",
        "errorCode":"1",
        "channelName":"10086",
        "channelId":"43357244164048",
        "status":0,
        "timestamp":1606984002551
    },
    "eventType":301
}

302 云端录制服务状态发生变化

云端录制任务状态发生变化时，比如开始录制、开始转码等，会触发此抄送。更多状态信息请参考云端录制状态码。

字段说明

字段	类型	示例	说明
eventType	Number	302	事件类型。
data	JSON 数组	-	抄送消息体。

data 结构的字段说明：

字段	类型	示例	说明
channelName	String	2005370	被录制的房间名称。
channelId	Number	43357129934800	被录制的房间 ID。
status	Number	2	云端录制状态码。详细说明请参考云端录制状态码。
timestamp	Number	1606984002243	该事件发生的 Unix 时间戳，单位为毫秒（ms）。

JSON 示例

json{
    "data":{
        "channelName":"2005370",
        "channelId":"43357129934800",
        "status":2,
        "timestamp":1606984002243
    },
    "eventType":302
}

303 录制的音频流状态变化

录制的音频流状态发生变化时，会触发此回调。

字段说明

字段	类型	示例	说明
eventType	Number	303	事件类型。
data	JSON 数组	-	抄送消息体。

data 结构的字段说明：

字段	类型	示例	说明
uid	Number	459821	用户 UID，表示录制的是哪个用户的视频流。
channelName	String	10086	被录制的房间名称。
channelId	Number	43357244164048	被录制的房间 ID。
status	Number	0	云端录制状态码。详细说明请参考云端录制状态码。
timestamp	Number	1606984002551	该事件发生的 Unix 时间戳，单位为毫秒（ms）。

JSON 示例

json{
    "data":{
        "uid":"459821",
        "channelName":"10086",
        "channelId":"43357244164048",
        "status":0,
        "timestamp":1606984002551
    },
    "eventType":303
}

304 录制的视频流状态变化

录制的视频流状态发生变化时，会触发此消息抄送。

字段说明

字段	类型	示例	说明
eventType	Number	304	事件类型。
data	JSON 数组	-	抄送消息体。

data 结构的字段说明：

字段	类型	示例	说明
uid	Number	459821	用户 UID，表示录制的是哪个用户的视频流。
channelName	String	10086	被录制的房间名称。
channelId	Number	43357244164048	被录制的房间 ID。
status	Number	0	云端录制状态码。详细说明请参考云端录制状态码。
timestamp	Number	1606984002415	该事件发生的 Unix 时间戳，单位为毫秒（ms）。

JSON 示例

json{
    "data":{
        "uid":"459821",
        "channelName":"10086",
        "channelId":"43357244164048",
        "status":0,
        "timestamp":1606984002415
    },
    "eventType":304
}

305 云端录制失败

云端录制失败时，会触发此消息抄送。

字段说明

字段	类型	示例	说明
eventType	Number	305	事件类型。
data	JSON 数组	-	抄送消息体。

data 结构的字段说明：

字段	类型	示例	说明
uid	Number	1234	用户 UID，表示录制的是哪个用户的视频流。
channelId	Number	234	被录制的房间 ID。
timestamp	Number	1606974909978	该事件发生的 Unix 时间戳，单位为毫秒（ms）。
code	Number	1	错误码。500 表示服务异常，导致云端录制失败。请联系技术支持处理。
channelName	String	abc	被录制的房间名称。
produceType	String	video	录制失败的流类型，包括： audio：音频流。 video：音视频流。 screenshare：屏幕共享。

JSON 示例

json{
  "eventType": 305,
  "data": {
    "uid":1234,
    "channelId":234,
    "timestamp":1606974909978,
    "code":1,
    "channelName":"abc",
    "produceType":"video"
 }
}

3 录制文件下载信息

当录制文件生成完毕，并且上传到点播系统成功后触发本抄送。

字段说明

字段	类型	示例	说明
eventType	Number	3	事件类型。
data	JSON 对象	-	抄送消息体。

data 结构的字段说明：

字段	类型	示例	说明
caller	Boolean	false	无效字段，请忽略。
channelId	Number	123	房间 ID。
channelName	String	123	房间名称。
filename	String	0-51657353189055-1606974909978-0-mix.mp4	文件名。混合录制文件的 filename 带有 -mix 标记，具体命名规则如下： 实时音视频单人录制文件：uid-cid-timestamp-sliceindex.filetype 实时音视频混合录制文件：0-cid-timestamp-sliceindex-mix.filetype 互动直播录制文件：taskId-cid-timestamp-sliceindex.filetype
md5	String	e66ff965e0f43bd4e3897e84cb245dd0	文件的 MD5 值。
size	String	24564438	文件大小，单位为字节。
type	String	mp4	文件的类型，即文件扩展名。包括： aac：实时音频录制文件。 mp4：实时视频录制文件。 flv：互动直播视频录制文件。
url	String	http://..126.net/***/0-51657353189055-1606974909978-0-mix.mp4	文件的下载地址。 如果点播域名开启了URL鉴权，您需要手工拼接防盗链 URL ，即在原始地址的最后手工增加 wsSecret 和 wsTime 相关的值，否则用户会无法访问相应的资源。拼接防盗链 URL 的方法请参见防盗链URL构成。
uid	Number	0	用户帐号，若该文件为混合录制文件，则该字段为 0。
taskId	String	abc	互动直播旁路推流任务 ID。请勿将此 taskId 和创建的录制任务 taskId 混淆，录制任务 ID 不会返回。
mix	Boolean	true	是否为混合录制文件。 true：混合录制文件。 false：单人录制文件。
vid	String	3333091818	点播文件 ID，通过该参数可以调用点播接口查询相关信息。
pieceIndex	String	0	录制文件的切片索引，如果单通通话录制时长超过切片时长，则录制文件会被且被切割成多个文件。
timestamp	Number	1606974909978	录制文件生成的系统时间。

JSON 示例

json{
  "eventType": 3,
  "data": {
    "vid": "3231091818",
    "pieceIndex": "0",
    "filename": "0-53657353689055-1606974909978-0-mix.mp4",
    "size": "24564438",
    "type": "mp4",
    "mix": true,
    "uid": 2221,
    "url": "http://*****.vod.126.net/*****/0-52657353689055-1606974909978-0-mix.mp4",
    "channelId": "52657353689055",
    "md5": "e66ff965e0f43bd4e3897e84cb245dd0",
    "timestamp": "1606974909978"
  }
}