查询RTMP设备录像列表
所有文档

          智能视联网平台 EVS

          查询RTMP设备录像列表

          接口描述

          本接口用于查询设备的录像文件列表。

          请求(Request)

          请求URI

          GET /v1/device/{deviceId}/recording?begin={begin}&end={end}&pageNo={pageNo}&pageSize={pageSize}

          参数名称 类型 是否必需 描述
          deviceId Long 设备ID
          begin Integer 录像开始时间,Unix时间戳,单位秒,形如"1617261115"
          end Integer 录像结束时间,Unix时间戳,单位秒,形如"1617261132"
          pageNo Integer 分页查询标识第几页
          pageSize Integer 分页查询标识每页多少条数据

          注意: begin与end参数组成一个左闭右开区间[start, end),查询时以录像的开始时间为查询点,在区间内进行查询。 举例如下: 若配置录像单文件时长为1小时,在一段时间后,存在以下录像文件:

          • record.a.mp4, startTime=2021-04-01 11:05:00
          • record.b.mp4, startTime=2021-04-01 12:05:01
          • record.c.mp4, startTime=2021-04-01 13:04:59
          • record.d.mp4, startTime=2021-04-01 14:05:00
          • record.e.mp4, startTime=2021-04-01 15:05:00 然后发起查询录像请求,指定参数start=1617247800(2021-04-01 11:30:00),end=1617258600(2021-04-01 14:30:00),会发现得到响应结果录像文件列表为 [record.b.mp4, record.c.mp4, record.d.mp4],不要怀疑,这完全符合系统预期。请理解查询录像的维度始终是录像开始时间,在多个连续的查询请求中,EVS会返回所有的录像文件。

          请求头域

          除公共头域外,无其它特殊头域。

          请求体

          响应(Response)

          响应头域

          除公共头域外,无其它特殊头域。

          响应体

          参数名称 类型 描述
          pageNo Integer 当前页数
          pageSize Integer 当前页的大小
          data Array 空间信息列表
          + title String 设备录像文件标题
          + thumbnailUrl String 设备录像封面图链接,从录像时段内随机取一张图
          + playUrl String 录像播放链接
          totalCount Integer 总个数

          示例

          请求示例

          GET /v1/device/1000001/recording?begin=1583335807&end=1583335807&pageNo=1&pageSize=10 HTTP/1.1
          x-bce-date: 2020-03-25T09:28:13Z
          host: evs.bj.baidubce.com
          content-type: application/json
          authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2020-03-25T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715

          响应示例

          HTTP/1.1 200 OK
          Transfer-Encoding: chunked
          x-bce-request-id: 012b9747-f13a-4a2c-a488-02b221844dca
          Cache-Control: no-cache
          Server: BWS
          Date: Tue, 24 Mar 202 013:34:07 GMT
          Content-Type: application/json;charset=UTF-8
          {
              "pageNo": 1,
              "pageSize": 10,
              "data": [
                  {
                      "title": "2020.06.28 19:10:11-19:11:11",
                      "thumbnailUrl": "http://xxx.xxx/xxx/xxx.jpg"
                      "playUrl": "http://xxx.xxx/xxx/xxx.mp4"
                  },
                  {
                      "title": "2020.06.28 19:11:11-19:12:12",
                      "thumbnailUrl": "http://xxx.xxx/xxx/xxx.jpg"
                      "playUrl": "http://xxx.xxx/xxx/xxx.mp4"
                  }
              ]
          }

          错误码

          参考公共错误码

          上一篇
          设备流直播
          下一篇
          查询RTMP设备截图列表