查询房间录制记录

更新时间: 2024/09/04 17:10:32

如果您的业务系统需要获取房间的录制记录以便进行回放,您可以通过该接口查询已结束房间的录制记录信息。

请求

URI

GET https://{endpoint}/neroom/v3/rooms/:room_archive_id/media_info

{endpoint} 为 NERoom 接入地址的域名,默认为 roomkit.netease.im。如果您的应用主要服务于海外用户,请将域名设置为海外数据中心域名(roomkit-sg.netease.im)。

请求 Header 的设置请参见 请求结构

路径参数

参数名称 类型 是否必选 示例 描述
room_archive_id String 4***251 创建房间时,NERoom 服务端自动生成的一个用于标识房间的 ID,全局唯一,最大长度36个字符。
获取方法请参见创建房间 中的返回参数。

请求示例

javahttps://roomkit.netease.im/neroom/v3/rooms/123/media_info

响应

响应参数

参数名称 类型 示例
描述
code Integer 0 状态码,0 表示成功,具体请参见错误码
msg String Success 业务结果描述,Success 表示成功。
ts Long 1648021056815 NERoom 服务器处理该请求的完成时间。该时间为 Unix 时间戳,即从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数。
request_id String 7c4b6d9c3e9d42*****cc6e3a4d995 请求的唯一标识。
cost String 48ms 处理该请求所消耗的时间。
data Object - 房间录制记录信息。

响应体示例

java{
    "code":0,
    "msg":"Success",
    "ts":1619068087795,
    "request_id":"6e507107d1f4447ea731f651dc6d2432",
    "cost":"66ms",
    "data":{
        "file_infos":[
            {
                "vid":1234567890,
                "create_time":1587718829022,
                "object_name":"123-22222222-1589020209203-0.mp4",
                "url":"http://vod9***.***.127.net/123-22222222-1589020209203-0.mp4"
            },
            {
                "vid":5432167890,
                "create_time":1587718828946,
                "object_name":"0-22222222-1589020209203-0-mix.mp4",
                "url":"http://vod9***.***.127.net/0-22222222-1589020209203-0-mix.mp4"
            }
        ]
    }
}

错误码

错误码 错误信息 说明 处理建议
0 Success 请求成功 无需处理
400 Invalid parameter. 参数错误 检查接口传参
1004 Room not found. 房间不存在或者已关闭 根据业务场景处理
此文档是否对你有帮助?
有帮助
去反馈
  • 请求
  • URI
  • Header
  • 路径参数
  • 请求示例
  • 响应
  • 响应参数
  • 响应体示例
  • 错误码