文档反馈
文档反馈

查询云端录制文件信息

重要通知

网易云信新版文档中心现已正式上线!

音视频通话2.0互动直播2.0多人语音聊天室PK 直播等产品和场景方案已迁移至新版文档中心维护,欢迎体验!

调用接口查询云端录制文件信息。

如果开启了云端录制消息抄送,录制完成后,文件信息会以抄送形式发送到您的指定服务器。您也可以主动调用本接口随时查询指定房间的录制文件信息,包括录制文件的文件名、URL等。

注意:

URL

请求参数

参数名称 类型 是否必选 示例 描述
channelId Long 52026368004000 房间 ID。该 ID 为创建房间接口调用成功后返回的房间 ID。

返回参数

参数名称 类型 示例 描述
code Number 200 错误码。
fileInfos JSONArray - 指定房间中生成的所有录制文件的对应信息。
channelId Long 52026368004000 房间 ID。

fileInfos:

参数名称 类型 示例 描述
createTime Number 1587718829022 云端录制文件的生成时间。
objectName String 123-22222222-1589020209203-0.mp4 云端录制生成的文件名。
url String http://vod9***.***.127.net/0-22222222-1589020209203-0-mix.mp4 云端录制文件的对应地址,获取此地址后可以通过播放器 SDK 播放。

示例

curl请求示例

curl -X POST -H "AppKey: go9dnk49bkd9jd**********" -H "Nonce: 4tgggergigwow********" -H "CurTime: 1443592222" -H "CheckSum: 9e9db3b6c9abb2e1962cf3e6f7316*******" -H "Content-Type: application/x-www-form-urlencoded" -d 'channelId=123' 'https://api.netease.im/nimserver/history/queryMediaFileByChannelId.action'

正常返回示例

{
  "code": 200,
  "fileInfos": [
    {
      "createTime": 1587718829022,
      "objectName": "123-22222222-1589020209203-0.mp4",
      "url": "http://vod9***.***.127.net/123-22222222-1589020209203-0.mp4"
    },
    {
      "createTime": 1587718828946,
      "objectName": "0-22222222-1589020209203-0-mix.mp4",
      "url": "http://vod9***.***.127.net/0-22222222-1589020209203-0-mix.mp4"
    }
  ],
  "channelId": 52026368004000
}

错误码

该接口在 HTTP Body 中返回错误码,错误码列表请参考录制文件相关错误码

×

反馈成功

非常感谢您的反馈,我们会继续努力做得更好。