本文介绍如何调用服务端接口获取房间内的录制记录列表。

请求

URI

GET https://{endpoint}/scene/apps/{appKey}/v2/rooms/record/list

• {endpoint} 为 NERoom 接入地址的域名，默认为 roomkit.netease.im。如果您的应用主要服务于海外用户，请将域名设置为海外数据中心域名（roomkit-sg.netease.im）。
• Content-Type：application/json

Header

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

路径参数

参数名称	类型	是否必选	描述
appKey	String	是	云信控制台申请的appKey。

请求体参数

参数名称	类型	是否必选	描述
roomArchiveId	Long	是	创建房间时，NERoom 服务端自动生成的一个用于标识房间的 ID，全局唯一，最大长度36个字符。

请求体示例

json{
  "roomArchiveId": 110119
}

响应

响应参数

参数名称	类型	示例	描述
code	int	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	-	房间录制记录结果。
- recordList	List<Object>	-	房间录制记录列表。
recordId	String	4***251	录制记录 ID。
recordStartTIme	Long	16900300000	录制开始时间，毫秒时间戳。
recordEndTIme	Long	16900300000	录制结束时间，毫秒时间戳。
- infoList	List<Object>	-	录制文件详细信息。
pieceIndex	Integer	0	录制文件分片索引。
userUuid	String	abc123	用户 ID。
nickname	String	zhangsan	在房间中的昵称。
type	String	mp4	文件的类型，即文件扩展名。包括： aac：实时音频录制文件。 mp4：实时视频录制文件。 flv：互动直播视频录制文件。
filename	String	0-1345944969xxx7143-0-mix.mp	文件名。混合录制文件的 filename 带有 -mix 标记，具体命名规则如下： 实时音视频单人录制文件：uid-cid-timestamp-sliceindex.filetype 实时音视频混合录制文件：0-cid-timestamp-sliceindex-mix.filetype 互动直播录制文件：taskId-cid-timestamp-sliceindex.filetype
mix	Boolean	true	是否为混合录制文件，true：混合录制文件，false：单人录制文件。
md5	String	81ff936xxxfb6cddffaa0	文件md5值。
size	Long	10612662	文件大小，单位为字节。
url	String	http://jdvodlacntafj.vod.126.net/jdvodlacntafj/0-1xxxx197143-0-mix.mp4	文件下载地址。
vid	Long	8337140563	点播文件id。

响应体示例

json{
  "code": 0,
  "msg": "Success",
  "ts": 1619068087795,
  "requestId": "6e507107d1f4447ea731f651dc6d2432",
  "cost": "66ms",
  "data": {
    "recordList": [
      {
        "recordId": "abcd1234",
        "recordStartTime": 16900000000,
        "recordEndTime": 16900200000,
        "infoList": [
          {
            "type": "mp4",
            "mix": true,
            "filename": "0-1345944969463779-1685953197143-0-mix.mp4",
            "md5": "81ff9369a85f2413a22c9fb6cddffaa0",
            "size": 10612662,
            "url": "http://jdvodlacntafj.vod.126.net/jdvodlacntafj/0-1345944969463779-1685953197143-0-mix.mp4",
            "vid": 8337140563,
            "pieceIndex": 0
          },
          {
            "type": "mp4",
            "mix": false,
            "filename": "1230-1345944969463779-1685953197143-0.mp4",
            "md5": "81ff9369a85f2413a22c9fb6cddffaa0",
            "size": 10612662,
            "url": "http://jdvodlacntafj.vod.126.net/jdvodlacntafj/1230-1345944969463779-1685953197143-0.mp4",
            "vid": 8337140563,
            "pieceIndex": 0,
            "userUuid": "abc123",
            "nickname": "进击的巨人"
          }
        ]
      },
      {
        "recordId": "abcd1222",
        "recordStartTime": 16900300000,
        "recordEndTime": 16900500000,
        "infoList": [
          {
            "type": "mp4",
            "mix": true,
            "filename": "0-1345944969463779-1685953197143-0-mix.mp4",
            "md5": "81ff9369a85f2413a22c9fb6cddffaa0",
            "size": 10612662,
            "url": "http://jdvodlacntafj.vod.126.net/jdvodlacntafj/0-1345944969463779-1685953197143-0-mix.mp4",
            "vid": 8337140563,
            "pieceIndex": 0
          },
          {
            "type": "mp4",
            "mix": false,
            "filename": "1230-1345944969463779-1685953197143-0.mp4",
            "md5": "81ff9369a85f2413a22c9fb6cddffaa0",
            "size": 10612662,
            "url": "http://jdvodlacntafj.vod.126.net/jdvodlacntafj/1230-1345944969463779-1685953197143-0.mp4",
            "vid": 8337140563,
            "pieceIndex": 0,
            "userUuid": "abc123",
            "nickname": "进击的巨人"
          }
        ]
      }
    ]
  }
}

错误码

错误码	错误信息	说明	处理建议
0	Success	请求成功	无需处理
400	Invalid parameter.	参数错误	检查接口传参