视图计算产品说明,用于理解和使用API。
一、空间、模板、设备、流说明
空间
视图计算的空间是用来管理设备和流的逻辑集合,空间包括以下信息
空间(管理流、设备、应用模板)
接入类型 *
RTMP、国标GB28181
域名 *
推流域名、播放域名(国标仅播放域名)
播放类型
RTMP、FLV、HLS
AppName
Live(默认)
回调地址
流、设备状态变化回调通知
按需拉流
RTMP空间不支持,国标空间支持
空间操作相关步骤
创建空间
选择接入类型
配置域名
说明域名是空间初始化一次性配置(请谨慎配置),不支持修改。域名默认开启URL鉴权,推流/播放U地址都是鉴权后的URL。空间下流可以被实时预览、回看前需要对域名进行CNAME解析配置,否则RTMP无法推流,国标仅能添加设备,无法播放。
全局模板
模板在视图计算产品中是全局模板,包括以下类型的模板
全局模板(创建、绑定、解绑)
录制模板
普通录制、按需录制、时移录制
截图模板
覆盖式截图、实时截图(按频率截图)、按需截图
转码模板
每个转码模板对应一组(最多4个)转码规格(不同输出码率、分辨率)
AI模板
AI模板用于视频智能视觉预测,每个AI模板对应一组预测模型
模板操作相关说明
录制、截图、转码、AI模板最后都是生效在流的维度,生效前需要进行模板的创建和绑定,绑定后流接入就触发模板工作。
除实时预览外,如果需要进行普通录制、时移录制、截图、转码、视频AI都需要先创建模板。
不再使用的模板可以解绑,解绑后流不再进行录制、截图、转码和AI预测。
如果流已经接入,需要重新起流新配置的时移、转码、AI模板才生效。
模板是全局属性,可以多个空间绑定同一个模板,部分模板支持绑定在流的维度,流维度模板优先级高于空间级绑定的模板。
设备
目前非RTMP接入的空间,都有设备的概念,设备信息如下
添加设备(国标空间)
国标ID
IPC用户自己配置/NVR、下游平台配置通过国标协议同步给视图计算产品
设备ID
视图计算产品生成
流ID
视图计算产品生成
流名称
国标空间设备流名称同国标ID
设备状态
在线、离线、锁定(设备注册信息错,需修改正确后解锁再次注册)、未注册(设备端未国标注册,服务端已添加设备)
流状态
在线、离线
国标设备的操作流程
国标注册:
视图计算API添加设备信息
摄像头/NVR/平台侧进行国标注册配置
获取设备状态:
设备成功接入后,设备状态会实时更新管理设备:对设备进行启动拉流、停流、PTZ等操作
获取放地址:
通过接口获取带鉴权播放URL进行播放
设备操控:
如果IPC则直接国标注册后进行设备操控,如果是NVR或平台接入,接入后通过NVR/平台通道来获取IPC的状态,进行操控、设备管理。
流
RTMP协议接入重点是生成推流和播放地址,对流可以进行禁止推流、恢复禁推等操作。
RTMP的空间,在配置了域名和域名鉴权后,用户可直接使用自定义推流URL进行推流。URL格式:rtmp://{domain name}/{appname}/{streamname}&auth={鉴权串}其中domain, appname在创建空间时初始化,streamname可以用户推流时自定义。
播放地址支持RTMP、FLV、HLS三种格式。
二、空间、流级别支持模板说明
空间、流级别支持模板类型的详细说明如下
空间级 | |||
录制 | 实时录制(按设置的频率生成录制文件,生成多段文件) | 按需录制(调一次开启API开始录制,调结束API录制停止,不调结束录制会一直录制到流断后结束) | |
截图 | 实时截图(按设置的频率截图,生成多张截图) | 覆盖截图(按设置的频率截图,后一张覆盖之前截图,仅保留最新一张) | 按需截图(调一次API生成一张截图) |
时移录制 | 可设置循环录制天数 | 备注:应用时移模板后重启流配置生效 | |
转码 | 一个转码模板最多可配置4个转码规则,对应4种转码流输出,每个空间默认支持10路转码流输出,如不满足需求,请工单申请。 | 备注:应用转码模板后需重启流配置生效 |
流级 | |||
录制 | 实时录制(按设置的频率生成录制文件,生成多段文件) | 按需录制(调一次开启API开始录制,调结束API录制停止,不调结束录制会一直录制到流断后结束) | |
截图 | 实时截图(按设置的频率截图,生成多张截图) | 覆盖截图(按设置的频率截图,后一张覆盖之前截图,仅保留最新一张) | 按需截图(调一次API生成一张截图) |
时移录制 | 可设置循环录制天数 | 备注:应用时移模板后重启流配置生效 | |
AI模板 | 流预测启动需要调智能视觉开始流预测API | 备注:应用AI模板后需重启流配置生效 |
创建空间(按业务类型的逻辑概念,不同空间使用该空间唯一初始化时使用的推/播流域名,国标空间仅需要播放域名,用于管理空间内的设备、流,RTMP空间仅管理流)。
创建模板,包括截图、录制、时移、转码(仅应用在空间纬度)、AI模板(仅应用在流纬度)。
绑定模板,把模板应用到空间后,接入流后模板生效。可以在流纬度配置截图、录制、时移、AI模板。如果流已经接入,配置了时移、AI模板需要重新推流模板生效。