VideoStream 视频流接口

  1. 获取直播流
  2. 获取回放流
  3. 获取录像片段
  4. 获取当前快照
  5. 获取当前视频片段
  6. 视频截取

1.获取直播流

描述

获取指定IPC直播流地址,接口返回两种不同分辨率的直播流,在网络条件有限的情况下建议优先选择播放较低分辨率的直播流。

接口

public void getLiveStream(String deviceId, RpcCallback‹RpcResponse‹LiveAddress›› callback);

参数说明

参数名称描述示例
deviceIdIPC序列号C201D98T00094
callback调用结果

响应参数

参数名称类型描述
codeint返回码,表示操作的结果;
本接口返回码有:0、1、3、5、7、232,见错误码的描述
dataLiveAddress返回码成功才会有此字段,详见RpcResponse.LiveAddress

2.获取回放流

描述

获取指定IPC回放流地址。

接口

public void getPlaybackStream(String deviceId, long startTime, long endTime RpcCallback‹RpcResponse‹PlaybackUrl›› callback);

参数说明

参数名称描述示例
deviceIdIPC序列号C201D98T00094
start_time回放开始时间,unix格式的时间戳,秒级1578969264
end_time回放结束时间,unix格式的时间戳,秒级1579055640
callback调用结果

响应参数

参数名称类型描述
codeint返回码,表示操作的结果;
本接口返回码有:0、1、3、5、7、230、235,见错误码的描述
dataPlaybackUrl返回码成功才会有此字段,详见RpcResponse.PlaybackUrl

3.获取录像片段

描述

获取指定指定时间内的录像片段。

接口

public void getRecordList(String deviceId, Map‹String, String› options, RpcCallback‹RpcResponse‹VideoRecordCollection›› callback);

参数说明

参数名称描述示例
deviceIdIPC序列号C201D98T00094
options获取的录像范围参数,option说明中的所有参数均需要转换成String类型传入。见下表options说明
callback调用结果

options说明

参数名称类型描述是否必须示例
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,见错误码的描述
dataVideoRecordCollection返回码成功才会有此字段,详见RpcResponse.VideoRecordCollection

4.获取当前快照

描述

获取指定IPC当前快照。

接口

public void getSnapshot(String deviceId, RpcCallback‹RpcResponse‹SnapshotUrl›› callback);

参数说明

参数名称描述示例
deviceIdIPC序列号C201D98T00094
callback调用结果

响应参数

参数名称类型描述
codeint返回码,表示操作的结果;
本接口返回码有:0、1、3、5、7、233,见错误码的描述
dataSnapshotUrl返回码成功才会有此字段,详见RpcResponse.SnapshotUrl

5.获取当前视频片段

描述

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

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

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

接口

public void getCurVideos(String deviceId, int preceding, int following, RpcCallback‹RpcResponse‹PresentVideoClip›› callback);

参数说明

参数名称描述示例
deviceIdIPC序列号C201D98T00094
preceding当前时间点之前的视频片段长度,只能是0,4,8 0
following当前时间点之后的视频片段长度,只能是0,4,8 8
callback调用结果

响应参数

参数名称类型描述
codeint返回码,表示操作的结果;
本接口返回码有:0、1、2、3、5、7、236、237,见错误码的描述
dataPresentVideoClip返回码成功才会有此字段,详见RpcResponse.PresentVideoClip

6. 视频截取

描述

获取任意IPC设备中任意时间段的完整视频片段,时间段小于30min。

接口

public void getRecordUrl(String deviceId, long startTime, long endTime,  RpcCallback‹RpcResponse‹PresentVideoClip›› callback);

参数说明

参数名称描述示例
deviceIdIPC序列号C201D98T00094
startTime起始unix时间1600691948
endTime结束unix时间1600692248
callback调用结果

响应参数

参数名称类型描述
codeint返回码,表示操作的结果;
本接口返回码有:0、1、2、3、5、7、236、237,见错误码的描述
dataPresentVideoClip返回码成功才会有此字段,详见RpcResponse.PresentVideoClip