云端录制事件抄送

更新时间: 2024/05/17 12:39:18

事件类型

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 ,即在原始地址的最后手工增加 wsSecretwsTime 相关的值,否则用户会无法访问相应的资源。拼接防盗链 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 云端录制完成抄送
  • 字段说明
  • JSON 示例
  • 301 云端录制服务发生错误
  • 字段说明
  • JSON 示例
  • 302 云端录制服务状态发生变化
  • 字段说明
  • JSON 示例
  • 303 录制的音频流状态变化
  • 字段说明
  • JSON 示例
  • 304 录制的视频流状态变化
  • 字段说明
  • JSON 示例
  • 305 云端录制失败
  • 字段说明
  • JSON 示例
  • 3 录制文件下载信息
  • 字段说明
  • JSON 示例