云端录制事件抄送 - 音视频通话 2.0

开发者中心

音视频通话 2.0

服务端 API

云端录制事件抄送

更新时间： 2024/12/10 17:59:44

本文介绍了网易云信音视频通话 2.0 云端录制事件的抄送事件。

事件类型

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

300 云端录制完成抄送

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

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

字段说明

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

data 结构的字段说明：

字段	类型	示例	说明
channelId	Number	1648490140509960	被录制的房间 ID。
channelName	String	qaz	被录制的房间名称。
timestamp	Number	1732119777349	数据生成的 Unix 时间戳，单位为毫秒（ms）。
detail	Array	-	-
- handleStats	Array	-	音视频组统计信息数组。
avDelay	Number	0	音视频不同步的包的数量。
dumpDisorder	Number	0	落盘乱序包数。
firstDumpTimestamp	Number	22	首包时间戳（毫秒）。
handleType	String	main	处理类型（如主流 `main`、辅流 `sub`、三流 `third`、四流 `fourth`）。
largestH	Number	360	视频流的最大高度（像素）。
largestW	Number	640	视频流的最大宽度（像素）。
recvBiggestTimestamp	Number	7199844	接收最大时间戳（毫秒）。
tsFixed	Number	0	修正时间戳包数。
logoutTime	Number	0	用户总退出时间（毫秒）。
- streamStats	Array	-	流统计信息数组。
baseSeq	Number	1631674	基础序列号。
decError	Number	0	解码错误帧数。
discardRate	Number	0	丢帧率。
disorder	Number	0	乱序帧数。
dump	Number	17820	落盘帧数。
error	Number	0	异常帧数。
frameLost	Number	0	接收视频丢帧数。
frameLostForI	Number	0	接收视频关键帧丢帧数。
lost	Number	0	丢帧数。
pktLost	Number	0	RTP 丢包数。
pktLostRate	Number	0	RTP 丢包率。
rtpSsrcPkt	Number	621351	RTP 包数。
- streamInfo	Object	-	流的详细信息。
dumpSeq	Number	607836	落盘序列号。
dumpTs	Number	7199541	落盘时间戳（毫秒）。
firstTs	Number	1732090188180	首帧时间戳。
seq	Number	454936	序列号。
ts	Number	1732118987782	当前时间戳（毫秒）。
streamType	String	audio	流的类型（audio 或 video）。可能值为： `audio`、`video`、`subAudio`、`subVideo`、`thirdVideo`、`fourthVideo`
total	Number	17820	总帧数。
uid	Number	8888	用户 ID。

JSON 示例

JSON{
    "channelName": "room_123",
    "channelId": 1341234567891011,
    "timestamp": 1733811830854,
    "detail": [
        {
            "logoutTime": 0,
            "uid": 66601,
            "streamStats": [
                {
                    "baseSeq": 0,
                    "discardRate": 0,
                    "pktLost": 0,
                    "streamInfo": {
                        "dumpSeq": 12412,
                        "dumpTs": 248459,
                        "firstTs": 1733811553309,
                        "seq": 12412,
                        "ts": 1733811801739
                    },
                    "frameLost": 0,
                    "pktLostRate": 0,
                    "rtpSsrcPkt": 12520,
                    "error": 0,
                    "disorder": 0,
                    "total": 12412,
                    "streamType": "audio",
                    "lost": 0,
                    "decError": 0,
                    "frameLostForI": 0,
                    "dump": 12412
                }
            ],
            "handleStats": [
                {
                    "largestH": 0,
                    "handleType": "main",
                    "largestW": 0,
                    "avDelay": 0,
                    "dumpDisorder": 0,
                    "tsFixed": 0,
                    "firstDumpTimestamp": 29,
                    "recvBiggestTimestamp": 248459
                }
            ]
        }
    ]
}

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 表示服务异常，导致云端录制失败。请 [提交工单](https://app.yunxin.163.com/global/service/ticket/create) 联系网易云信技术支持工程师处理。
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"
  }
}

此文档是否对你有帮助？

有帮助

去反馈

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