1.获取直播流
描述
获取指定IPC直播流地址。
请求地址
https://192.168.0.1/openapi/media/getLiveStream
请求参数
本接口没有私有参数,公共参数见公共参数一节描述。
响应参数
参数名称 | 类型 | 描述 |
code | int | 返回码,表示操作的结果; 本接口返回码有:0、1、3、5、7、232,见错误码的描述 |
hd_live_url | string | 高清直播地址,RTSP协议 |
fhd_live_url | string | 全高清直播地址,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_time | long | 回放开始时间,unix格式的时间戳,秒级 | Y | 1578969264 |
end_time | long | 回访结束时间,unix格式的时间戳,秒级 | Y | 1579055640 |
响应参数
参数名称 | 类型 | 描述 |
code | int | 返回码,表示操作的结果; 本接口返回码有:0、1、3、5、7、230、235,见错误码的描述 |
playback_url | string | 视频回放地址,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_time | long | 指定开始时间,unix格式的时间戳,秒级 | Y | 1578969264 |
end_time | long | 指定结束时间,unix格式的时间戳,秒级 | Y | 1579055640 |
page_num | int | 当前页码,默认值和最小值为1 | N | 1 |
page_size | int | 当前页面条目数,默认为10,范围为[1, 100] | N | 10 |
响应参数
参数名称 | 类型 | 描述 |
code | int | 返回码,表示操作的结果; 本接口返回码有:0、1、3、5、7、231、234、235,见错误码的描述 |
total_num | int | 符合条件的视频总数量,每个视频大概1分钟时长 |
return_num | int | 当前返回的视频数量 |
start_time | long | 视频的开始时间 |
end_time | long | 视频的结束时间 |
url | string | 视频的下载链接 |
请求示例
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
请求参数
本接口没有私有参数,公共参数见公共参数一节描述。
响应参数
参数名称 | 类型 | 描述 |
code | int | 返回码,表示操作的结果; 本接口返回码有:0、1、3、5、7、233,见错误码的描述 |
snapshot_url | string | 快照下载地址 |
请求示例
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
请求参数
这里只列出接口的私有参数,公共参数见公共参数一节描述。
参数名称 | 类型 | 描述 | 是否必须 | 示例 |
preceding | int | 当前时间点之前的视频片段长度,只能是0,4,8 | Y | 0 |
following | int | 当前时间点之后的视频片段长度,只能是0,4,8 | Y | 8 |
响应参数
参数名称 | 类型 | 描述 |
code | int | 返回码,表示操作的结果; 本接口返回码有:0、1、2、3、5、7、236、237,见错误码的描述 |
url | string | 视频片段下载链接,在生成后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×tamp=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_time | long | 指定开始时间,unix格式的时间戳,秒级 | Y | 1578969264 |
end_time | long | 指定结束时间,unix格式的时间戳,秒级 | Y | 1579055640 |
响应参数
参数名称 | 类型 | 描述 |
code | int | 返回码,表示操作的结果; 本接口返回码有:0、1、3、5、7、231、234、235,见错误码的描述 |
url | string | 录像片段的下载链接 |
请求示例
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” } } |