获取录像回放地址

接口描述

获取设备录像回放地址，要能够成功访问此接口并得到播放地址有几下几个条件：

  • 该设备已经被绑定到你的账号下
  • 设备支持此功能（请与臻识销售咨询您的设备是否支持）

请求说明

接口ID 协议 方法 PATH
21 HTTPS GET /openapi/v1/stp/user/devices/video/record_url

PATH参数

无

URL参数

参数 类型 必填 说明
accesskey_id string 是 参见签名认证
expires int 是 参见签名认证
signature string 是 参见签名认证
sn string 是 设备序列号
type string 是 1：本地录像（国标设备必选1） 2：云存录像 0：自动（优先查询云存录像）
channel string 否 通道号，当type为0和1时必填 （国标设备通道号使用20位通道编号）
stream string 否 码流号，0：主码流；1：子码流。不传则播放该时段内有录像的码流；传则精确匹配该码流的录像
event_type string 否 事件类型，配合 stream 精确匹配某段录像（取自「查询设备录像列表」返回值的 event_type）。不传则按时段匹配；传了但该时段无此事件的录像时，按无录像处理
begin_time int 是 开始时间（Unix时间戳，秒）
end_time int 是 结束时间（Unix时间戳，秒）
unique_id string 否 事件唯一ID，当type为0和2时必填

注意：本地录像返回http-flv类型的地址，云存录像返回hls(m3u8)类型的地址

请求示例

GET https://open.vzicloud.com/openapi/v1/stp/user/devices/video/record_url?sn=51010723991187000001&channel=34020000001320000005&type=1&begin_time=1726070400&end_time=1726104761&accesskey_id=Cedc5EKV6125942kUrpItQIoo9OtMGup&expires=1726113130&signature=SKe6%2B2EqK4KgwHDhkKbc1z7e7iA%3D HTTP/1.1
Host: open.vzicloud.com

注意：您无法将请求示例的链接地址贴入浏览器直接运行，此示例仅展示URL格式，由于AccessKey具备有效期，您访问时此链接已过期。

返回说明

返回参数

参数 类型 说明
id string 流ID（本地录像返回）
url string 播放地址
proto string 本地录像固定为flv; 云存录像返回hls

注意：接口返回的url包含有效期，请千万不要将返回的url存储长期使用，否则有效期过了将无法播放视频。

本地录像的播放地址为 http-flv 格式，形如 https://<流媒体域名>/<sn>/<channel>_<stream>/playback.flv?id=<流ID>，地址里只包含 id，具体的通道/时段/码流参数由服务端关联，无需客户端拼接。

返回示例

{
  "id": "5d4b8e20-1455-11f0-91b1-4cedfb687489",
  "proto": "flv",
  "url": "https://video.vzicloud.com/51010723991187000001/34020000001320000005_0/playback.flv?id=5d4b8e20-1455-11f0-91b1-4cedfb687489"
}

results matching ""

    No results matching ""