视频流API

  1. 获取直播流
  2. 获取回放流
  3. 获取录像文件列表
  4. 获取当前快照
  5. 获取当前视频片段
  6. 获取录像片段下载地址

1.获取直播流

描述

获取指定IPC直播流地址。

请求地址

https://192.168.0.1/openapi/media/getLiveStream

请求参数

本接口没有私有参数,公共参数见公共参数一节描述。

响应参数

参数名称类型描述
codeint返回码,表示操作的结果;
本接口返回码有:0、1、3、5、7、232,见错误码的描述
hd_live_urlstring高清直播地址,RTSP协议
fhd_live_urlstring全高清直播地址,RTSP协议

请求示例

POST /openapi/media/getLiveStreamHTTP/1.1
Host: 192.168.0.1
Content-Type: application/x-www-form-urlencoded

app_id=mdk923idkf&random=289192×tamp=1564565937&sign=IDKNFLK392038KDS932K

返回示例

{
   “code”:              0,
   “data”: {
      “hd_live_url”:  “rtsp://192.168.0.1/ed98eeead4c843f898fef1c203313364/live_hd.sdp”,
      “fhd_live_url”:  “rtsp://192.168.0.1/ed98eeead4c843f898fef1c203313364/live_fhd.sdp”
  }
}

2.获取回放流

描述

获取指定IPC回放流地址。

请求地址

https://192.168.0.1/openapi/media/getPlaybackStream

请求参数

这里只列出接口的私有参数,公共参数见公共参数一节描述。

参数名称类型描述是否必须示例
start_timelong回放开始时间,unix格式的时间戳,秒级Y1578969264
end_timelong回访结束时间,unix格式的时间戳,秒级Y1579055640

响应参数

参数名称类型描述
codeint返回码,表示操作的结果;
本接口返回码有:0、1、3、5、7、230、235,见错误码的描述
playback_urlstring视频回放地址,RTSP协议

请求示例

POST /openapi/media/getLiveStream HTTP/1.1
Host: 192.168.0.1
Content-Type: application/x-www-form-urlencoded

app_id=mdk923idkf&random=289192×tamp=1564565937&sign=IDKNFLK392038KDS932K&start_time=1564565637&end_time=1564565697

返回示例

{
   “code”:              0,
   “data”: {
       “playback_url”:  “rtsp://192.168.0.1/ed98eeead4c843f898fef1c203313364/pb.sdp”
    }
}

3.获取录像文件列表

描述

获取指定指定时间内的录像文件列表。此接口按文件返回结果,列表中可能包含多个文件下载地址。

请求地址

https://192.168.0.1/openapi/media/getRecordList

请求参数

这里只列出接口的私有参数,公共参数见公共参数一节描述。

参数名称类型描述是否必须示例
start_timelong指定开始时间,unix格式的时间戳,秒级Y1578969264
end_timelong指定结束时间,unix格式的时间戳,秒级Y1579055640
page_numint当前页码,默认值和最小值为1N1
page_sizeint当前页面条目数,默认为10,范围为[1, 100]N10

响应参数

参数名称类型描述
codeint返回码,表示操作的结果;
本接口返回码有:0、1、3、5、7、231、234、235,见错误码的描述
total_numint符合条件的视频总数量,每个视频大概1分钟时长
return_numint当前返回的视频数量
start_timelong视频的开始时间
end_timelong视频的结束时间
urlstring视频的下载链接

请求示例

POST /openapi/media/getRecordList HTTP/1.1
Host: 192.168.0.1
Content-Type: application/x-www-form-urlencoded

app_id=mdk923idkf&random=289192×tamp=1564565937&sign=IDKNFLK392038KDS932K&start_time=1564565216&end_time=1564565697&page_num=2&page_size=30

返回示例

{
   “code”:              0,
   “data”: {
    “total_num”: 100,
    “return_num”: 30,
    “record_list”:[{
    “start_time”: 1564565216,
    “end_time”: 1564565276,
    “url”:  “https://192.168.0.1/mnt/sd-card/sunmi_video/video_plan/20190731172656_20190731172756.flv?auth_key=1564643800-efc1f64efb0d1d8fab35f0fe8c823a34”}, …]
   }
}

4.获取当前快照

描述

获取指定IPC当前快照。

请求地址

https://192.168.0.1/openapi/media/getSnapshot

请求参数

本接口没有私有参数,公共参数见公共参数一节描述。

响应参数

参数名称类型描述
codeint返回码,表示操作的结果;
本接口返回码有:0、1、3、5、7、233,见错误码的描述
snapshot_urlstring快照下载地址

请求示例

POST /openapi/media/getSnapshot HTTP/1.1
Host: 192.168.0.1
Content-Type: application/x-www-form-urlencoded

app_id=mdk923idkf&random=289192×tamp=1564565937&sign=IDKNFLK392038KDS932K

返回示例

{
   “code”:              0,
   “data”: {
      “snapshot_url”:  “https://192.168.0.1/tmp/snapshot/FM0101122334455_20190726162335.jpg?auth_key=1564129415-215f61f3c5f552c5bf8f43ccef5c66a9”
  }
}

5.获取当前视频片段

描述

获取当前时间往前(和/或)往后一点时间的视频片段。

获取视频片段的粒度为4s,用户在调用该接口的时候,设备会在截取当前时间之前的一段视频(以4s为单位)+当前时间点的4s片段+当前时间之后的一段视频片段 (以4s为单位) ,并返回用户视频下载连接。

视频下载连接在调用完成后4~12s生效,生效时间与用户传入的following参数有关。

请求地址

https://192.168.0.1/openapi/media/getCurVideos

请求参数

这里只列出接口的私有参数,公共参数见公共参数一节描述。

参数名称类型描述是否必须示例
precedingint当前时间点之前的视频片段长度,只能是0,4,8Y0
followingint 当前时间点之后的视频片段长度,只能是0,4,8 Y8

响应参数

参数名称类型描述
codeint返回码,表示操作的结果;
本接口返回码有:0、1、2、3、5、7、236、237,见错误码的描述
urlstring视频片段下载链接,在生成后4~12s生效

请求示例

POST /openapi/media/getCurVideos HTTP/1.1
Host: 10.10.61.206
Content-Type: application/json
Content-Length: 111
Connection: Keep-Alive
Accept-Encoding: gzip, deflate
Accept-Language: zh-CN,en,*
User-Agent: Mozilla/5.0
app_id=123&timestamp=1585743081&random=7783515117&following=0&preceding=0&sign=F4A04BDBE60D9C656A23CD945F703DA2

返回示例

{
“data”:
{
“url”:”https://10.10.63.19/mnt/sd-card/video_slicer/1585741874923_0_0.flv?auth_key=1585741878-c41f9a8751fe0c259b3d00b3842aa668″
},
“code”:0
}

6.获取录像片段下载地址

描述

获取指定指定时间内的录像片段下载地址。此接口会将多个录像片段合并为一个文件下载。

请求地址

https://192.168.0.1/openapi/media/getRecordUrl

请求参数

这里只列出接口的私有参数,公共参数见公共参数一节描述。

参数名称类型描述是否必须示例
start_timelong指定开始时间,unix格式的时间戳,秒级Y1578969264
end_timelong指定结束时间,unix格式的时间戳,秒级Y1579055640

响应参数

参数名称类型描述
codeint返回码,表示操作的结果;
本接口返回码有:0、1、3、5、7、231、234、235,见错误码的描述
urlstring录像片段的下载链接

请求示例

POST /openapi/media/getRecordUrl HTTP/1.1
Host: 192.168.0.1
Content-Type: application/x-www-form-urlencoded

app_id=mdk923idkf&random=289192×tamp=1564565937&sign=IDKNFLK392038KDS932K&start_time=1564565216&end_time=1564565697

返回示例

{
   “code”:              0,
   “data”: {
    “url”:  “https://192.168.0.1/record/C101E96500009/1564565216_ 1564565697.flv?auth_key=efc1f64efb0d1d8fab35f0fe8c823a34”
   }
}