EZOPEN协议
EZOPEN协议是萤石专为开发者设计的针对UIKit使用视频资源URL的协议,目前支持视频的预览、回放功能
UIKit覆盖的平台包含:iOS、Android、H5/Web。
详细格式如下(中括号为可选字段):
预览:ezopen://[验证码@]域名/序列号/通道号[.清晰度].live[?参数1=值&参数2=值]
示例:
“ezopen://open.ys7.com/440912260
/1
.hd
.live
”,可以播放序列号为“440912260
”设备“1通道
”“高清
”的“实时视频
”
回放:ezopen://[验证码@]域名/序列号/通道号[.回放源].rec[?参数1=值&参数2=值]
示例:
“ezopen://open.ys7.com/440912260
/1
.local
.rec
?begin=yyyyMMddhhmmss&end=yyyyMMddhhmmss
”,可以播放序列号为“440912260
”设备“1通道
”的“本地录像视频
”
关键字 | 必填 | 说明 |
---|---|---|
ezopen:// | √ | 协议头,固定为ezopen://格式 |
验证码 | 可选 | 视频加密密码,默认设备标签上的6位验证码,修改密码后同步新的密码,支持1-12位大小写英文字母与数字注意 只有开启视频加密的时候需要填入 |
域名 | √ | 服务地址 1.open.ezviz.com,指向开放平台国际站 2.global.open.ezviz.com,指向开放平台国际站 注意: 此功能需版本≥2.0 |
序列号 | √ | 设备的序列号(ID),设备标签上的9位数字序列号 |
通道号 | √ | 设备的通道编号 IPC(摄像机)固定为1,NVR可能有多个通道, |
清晰度 | 可选 | 支持:标准清晰度(缺省值)、高清(hd) |
回放源 | 可选 | 支持:自动选择(缺省值)、本地存储(local)、云存储(cloud) |
live | √ | 固定为live,表示实时视频(预览) |
rec | √ | 固定为rec,表示录像播放(回放)注意: 此功能需版本≥1.1 |
参数 | 可选 | 可以支持扩展控制参数,如静音(mute)、回放时间区间(begin,end)、指定流媒体服务器(vtdu)等,参数以key=value形式表示,多个参数使用&符号连接注意: 此功能需版本≥1.1 |
参数说明
参数 | 版本 | 使用范围 | 说明 |
---|---|---|---|
mute | ≥1.1 | live/rec | 播放视频静音,值:false(缺省)、true |
begin/end | ≥1.1 | rec | 按照时间区间回放录像,值格式:yyyyMMddhhmmss注意: 1.可以省略ss或mmss或hhmmss;2.end可以省略,无end的时候end=begin的yyyyMMdd235959; 3.begin和end都没有的时候(缺省),回放今日时间的:begin=yyyyMMdd000000,end=yyyyMMdd235959 |
alarmId | ≥1.2 | rec | 按照告警消息回放录像,值:告警消息的ID |
... | 更多特性开发中... |