视图计算产品说明,用于理解和使用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模版需要重新推流模版生效。