查询已结束房间的录制记录信息。

使用场景：如果您的业务系统需要获取房间的录制记录以便进行回放，您可以通过该接口查询录制信息。

接口请求地址

• 请求方法：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 播放。 如果点播域名开启了 URL 鉴权，您需要手工拼接防盗链 URL ，即在原始地址的最后手工增加 wsSecret 和 wsTime 相关的值，否则用户会无法访问相应的资源。拼接防盗链 URL 的方法请参见防盗链URL构成。
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
    }
}