云端录制回调
更新时间：2024-08-15
录制回调配置
百度智能云实时音视频 RTC 支持通过控制台自助配置录制回调地址，来接收云端录制事件回调。
配置录制回调步骤
- 访问 RTC 控制台。
- 访问 应用管理 -> 应用 -> 回调配置。
- 编辑 录制回调，输入回调地址，点击确认。
注意事项
- 录制回调地址必须是公网可以访问的 HTTP/HTTPS 地址；
- 需要在开启录制、并且配置了录制回调的情况下，回调服务器才能收到百度智能云 RTC 服务器发送的录制事件回调。
回调内容
回调 HTTP 方法
百度智能云 RTC 服务器，向回调地址发送请求，统一使用 HTTP POST 方法。
回调请求体
录制事件回调请求体主要字段及描述如下：
| 字段名称 | 类型 | 描述 |
|---|---|---|
| ts | Long | 事件发送时间，为毫秒级别 Unix 时间戳 |
| eventType | String | 事件类型，当前仅支持取值 RECORDING_FILE_UPLOAD_FINISH |
| recordingMode | String | 录制模式，"0"表示单路录制，"1"表示混流录制 |
| appId | String | 应用ID |
| roomName | String | 房间名 |
| clientUserIdList | List |
参与混流的客户端用户ID列表，单路录制时列表中只包含单个用户，混流录制时包含所有参与混流的用户 |
| eventInfo | EventInfo | 事件信息。在不同类型事件中，事件信息字段不同，取值含义也不同 |
| +eventTs | Long | 事件发生时间，为毫秒级别 Unix 时间戳 |
| +status | Integer | 事件状态 |
| +errMsg | String | 错误信息。当 status 存在且不为 0 时，对应的错误信息 |
当 eventType=RECORDING_FILE_UPLOAD_FINISH 时，eventInfo 中除了包含 eventTs、status 和 errMsg 字段以外，还包含一些录制文件相关字段，具体字段及取值含义:
| 字段名称 | 名称 | 描述 |
|---|---|---|
| eventTs | Long | 事件发生时间，为毫秒级别 Unix 时间戳 |
| status | Integer | 事件状态。 0：代表录制文件正常上传至存储平台 1：代表录制文件滞留在服务器或者备份存储上 |
| errMsg | String | 错误信息。当 status 存在且不为 0 时，对应的错误信息 |
| startTs | Long | 录制文件开始时间，为毫秒级别 Unix 时间戳 |
| endTs | Long | 录制文件结束时间，为毫秒级别 Unix 时间戳 |
| fileInfo | RecordingFileInfo | 存储平台和文件信息 |
| +vendor | String | 存储平台，取 "0" 表示百度智能云对象存储 BOS |
| +host | String | 存储平台服务地址 |
| +bucket | String | 存储文件 bucket |
| +filePath | String | 文件路径 |
| +fileUrl | String | 文件下载 url。 需要注意的是，文件下载 url，目前仅适配百度智能云对象存储 BOS，并且不包含 url 鉴权等信息。 |
回调内容示例
{
"eventType":"RECORDING_FILE_UPLOAD_FINISH",
"appId":"testapp",
"roomName":"654321",
"recordingMode": "1",
"clientUserIdList": [123456,123123],
"eventInfo":{
"eventTs":1663595954367,
"status":0,
"startTs":1663595909000,
"endTs":1663595954224,
"fileInfo":{
"vendor":"0",
"host":"bj.bcebos.com",
"bucket":"test",
"filePath":"/path/test.flv",
"fileUrl":"https://test.bj.bcebos.com/path/test.flv"
}
},
"ts":1663595945097
}