录制事件通知
回调说明
-
请求方法：POST
-
数据格式：JSON
-
请求地址：请在SDK管理后台上配置回调地址
-
传输协议：HTTP
回调参数
| 名称 | 类型 | 说明 |
|---|---|---|
| eventType | String | 回调事件 RECORD_FILE_STATE |
| time | Long | 通知时间戳，单位：秒 |
| signature | String | 签名 |
| details | Object | 详细内容 |
| details.RoomId | Long | 房间id |
| details.mixerID | String | 混图器ID |
| details.evType | Integer | 事件类型 1 输出开始；2 输出结束；3 输出失败； 4 文件上传中； 5 文件上传完成；6 上传失败； 7 完成（暂不使用）0-7，针对单个文件； 8 所有录像文件上传完成； 100 长时间未收到视频流； 101 推流失败，重试过程中一直发送该错误，可能发送多次； 102 下载封面失败（录像将没有预定的封面）； 103 录像文件已经上传； 200 mcu运行超时（超过最大值小时）； 201 mcu与mcum握手超时； |
| details.evtDat | Object | 事件扩展参数 |
请根据evType不同的取值，evtDat字段做不同的数据解析。
evType=1，输出开始：
| 参数 | 类型 | 说明 |
|---|---|---|
| outputName | String | 文件名/推流地址 |
evType=2，输出结束：
| 参数 | 类型 | 说明 |
|---|---|---|
| outputName | String | 文件名/推流地址 |
| startTime | int | 创建时间(从1970年1月1日00:00:00起的毫秒数) |
| duration | int | 录像时长(ms) |
| size | int | 文件大小(Byte) |
evType=3，输出错误：
| 参数 | 类型 | 说明 |
|---|---|---|
| outputName | String | 文件名/推流地址 |
| errCode | int | 错误码 |
| errDesc | string | 错误描述 |
evType=4，文件上传中：
| 参数 | 类型 | 说明 |
|---|---|---|
| outputName | String | 文件名/推流地址 |
| progress | float | 上传进度（0~100.0） |
evType=5，文件上传完成：
| 参数 | 类型 | 说明 |
|---|---|---|
| outputName | String | 文件名/推流地址 |
| startTime | int | 创建时间(从1970年1月1日00:00:00起的毫秒数) |
| duration | int | 录像时长(ms) |
| size | int | 文件大小(Byte) |
evType=6，文件上传失败：
| 参数 | 类型 | 说明 |
|---|---|---|
| outputName | String | 文件名/推流地址 |
| errCode | int | 错误码 |
| errDesc | String | 错误描述 |
evType=8，所有文件完成：
| 名称 | 类型 | 说明 |
|---|---|---|
| allFileState | int | 录制文件上传整体状态, 0：全部未上传，1：全部上传成功，2：部分上传成功 |
| allFileInfo | AllFileInfo[] | 文件列表 |
-
AllFileInfo数组内容
名称 类型 说明 state Integer 上传状态 值为5，表示上传完成 值为6，表示上传失败 svrFilePathName String 服务器路径文件名 duration Long 文件时长 fileSize Long 文件大小
evType=100，未接收到流数据：
| 参数 | 类型 | 说明 |
|---|---|---|
| eventDesc | String | 事件描述 |
| outputName | String | 文件名/推流地址 |
| streamID | String | 摄像头id |
evType=101，推流失败：
| 参数 | 类型 | 说明 |
|---|---|---|
| eventDesc | String | 事件描述 |
| outputName | String | 文件名/推流地址 |
evType=102，生成封面失败：
| 参数 | 类型 | 说明 |
|---|---|---|
| eventDesc | String | 事件描述 |
evType=103，录像文件已经上传：
| 参数 | 类型 | 说明 |
|---|---|---|
| eventDesc | String | 事件描述 |
| outputName | String | 文件名/推流地址 |
evType=200，录制服务运行超时：
| 参数 | 类型 | 说明 |
|---|---|---|
| eventDesc | String | 事件描述 |
evType=201，录制服务握手超时：
| 参数 | 类型 | 说明 |
|---|---|---|
| eventDesc | String | 事件描述 |
数据示例
{
"time": 1772616305,
"eventType": "RECORD_FILE_STATE",
"signature": "6590c4854079fe2faa47933c3db8d624",
"details": {
"mixerID": "05a224040f714be19f656fdf649a173b",
"evtDat": {
"allFileInfo": [
{
"duration": 0,
"fileSize": 0,
"state": 6,
"svrFilePathName": "/2026-03-04/2026-03-04_17-22-56_web_65349093_unaflow/H5用户429_172258.mp3"
},
{
"duration": 0,
"fileSize": 0,
"state": 6,
"svrFilePathName": "/2026-03-04/2026-03-04_17-22-56_web_65349093_unaflow/H5用户429_cam2_172259.mp4"
}
],
"allFileState": 0
},
"RoomId": 65349093,
"evType": 8
}
}
返回响应
返回 HTTP status code 为 2XX （例如 200）表示成功，其他响应都表示失败。