查询房间录制记录
更新时间： 2024/11/04 15:22:15
查询已结束房间的录制记录信息。
使用场景：如果您的业务系统需要获取房间的录制记录以便进行回放，您可以通过该接口查询录制信息。
接口请求地址
- 请求方法：GET
- URL：https://roomkit.netease.im/apps/v2/room-media?roomArchiveId={roomArchiveId}
URL 中参数说明
请求 Header 的设置请参见 请求结构。
| 参数名称 | 类型 | 是否必选 | 示例 | 描述 |
|---|---|---|---|---|
| roomArchiveId | String | 是 | 4***251 | 创建房间时，NERoom 服务端自动生成的一个用于标识房间的 ID，全局唯一，最大长度36个字符。 获取方法请参见创建房间 中的返回参数。 |
返回参数
| 参数名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| code | int | 0 | 状态码，0 表示成功，具体请参见错误码。 |
| msg | String | Success | 业务结果描述，Success 表示成功。 |
| ts | Long | 1648021056815 | NERoom 服务器处理该请求的完成时间。该时间为 Unix 时间戳，即从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数。 |
| requestId | String | 7c4b6d9c3e9d42*****cc6e3a4d995 | 请求的唯一标识。 |
| cost | String | 48ms | 处理该请求所消耗的时间。 |
| data | Object | - | 房间录制记录信息。 |
| data.channelId | String | 52026368004000 | 音视频房间 ID。 |
| data.fileInfos | List | - | 录制文件信息。 |
| data.fileInfos.vid | String | 1234567890 | 云端录制文件的标识。 |
| data.fileInfos.objectName | String | 0-22222222-1589020209203-0-mix.mp4 | 云端录制生成的文件名。 |
| data.fileInfos.url | String | http://vod9***.***.127.net/0-22222222-1589020209203-0-mix.mp4 |
云端录制文件的对应地址，获取此地址后可以通过播放器 SDK 播放。 |
| data.fileInfos.createTime | Long | 1587718829022 | 云端录制文件的生成时间。 |
示例
请求示例
javahttps://roomkit.netease.im/apps/v2/room-media?roomArchiveId=142576
返回示例
java{
"code":0,
"msg":"Success",
"ts":1619068087795,
"requestId":"6e507107d1f4447ea731f651dc6d2432",
"cost":"66ms",
"data":{
"fileInfos":[
{
"vid":1234567890,
"createTime":1587718829022,
"objectName":"123-22222222-1589020209203-0.mp4",
"url":"http://vod9***.***.127.net/123-22222222-1589020209203-0.mp4"
},
{
"vid":5432167890,
"createTime":1587718828946,
"objectName":"0-22222222-1589020209203-0-mix.mp4",
"url":"http://vod9***.***.127.net/0-22222222-1589020209203-0-mix.mp4"
}
],
"channelId":52026368004000
}
}
此文档是否对你有帮助？
