文档

新手必读

更新时间:

视图计算产品说明,用于理解和使用API。

一、空间、模板、设备、流说明

  1. 空间

    视图计算的空间是用来管理设备和流的逻辑集合,空间包括以下信息

    空间(管理流、设备、应用模板)

    接入类型 *

    RTMP、国标GB28181

    域名 *

    推流域名、播放域名(国标仅播放域名)

    播放类型

    RTMP、FLV、HLS

    AppName

    Live(默认)

    回调地址

    流、设备状态变化回调通知

    按需拉流

    RTMP空间不支持,国标空间支持

    空间操作相关步骤

    • 创建空间

    • 选择接入类型

    • 配置域名

    说明

    域名是空间初始化一次性配置(请谨慎配置),不支持修改。域名默认开启URL鉴权,推流/播放U地址都是鉴权后的URL。空间下流可以被实时预览、回看前需要对域名进行CNAME解析配置,否则RTMP无法推流,国标仅能添加设备,无法播放。

  2. 全局模板

    模板在视图计算产品中是全局模板,包括以下类型的模板

    全局模板(创建、绑定、解绑)

    录制模板

    普通录制、按需录制、时移录制

    截图模板

    覆盖式截图、实时截图(按频率截图)、按需截图

    转码模板

    每个转码模板对应一组(最多4个)转码规格(不同输出码率、分辨率)

    AI模板

    AI模板用于视频智能视觉预测,每个AI模板对应一组预测模型

    模板操作相关说明

    • 录制、截图、转码、AI模板最后都是生效在流的维度,生效前需要进行模板的创建和绑定,绑定后流接入就触发模板工作。

    • 除实时预览外,如果需要进行普通录制、时移录制、截图、转码、视频AI都需要先创建模板。

    • 不再使用的模板可以解绑,解绑后流不再进行录制、截图、转码和AI预测。

    • 如果流已经接入,需要重新起流新配置的时移、转码、AI模板才生效。

    • 模板是全局属性,可以多个空间绑定同一个模板,部分模板支持绑定在流的维度,流维度模板优先级高于空间级绑定的模板。

  3. 设备

    目前非RTMP接入的空间,都有设备的概念,设备信息如下

    添加设备(国标空间)

    国标ID

    IPC用户自己配置/NVR、下游平台配置通过国标协议同步给视图计算产品

    设备ID

    视图计算产品生成

    流ID

    视图计算产品生成

    流名称

    国标空间设备流名称同国标ID

    设备状态

    在线、离线、锁定(设备注册信息错,需修改正确后解锁再次注册)、未注册(设备端未国标注册,服务端已添加设备)

    流状态

    在线、离线

    国标设备的操作流程

    • 国标注册:

      1. 视图计算API添加设备信息

      2. 摄像头/NVR/平台侧进行国标注册配置

    • 获取设备状态:

      设备成功接入后,设备状态会实时更新管理设备:对设备进行启动拉流、停流、PTZ等操作

    • 获取放地址:

      通过接口获取带鉴权播放URL进行播放

    • 设备操控:

      如果IPC则直接国标注册后进行设备操控,如果是NVR或平台接入,接入后通过NVR/平台通道来获取IPC的状态,进行操控、设备管理。

  4. 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模板后需重启流配置生效

  1. 创建空间(按业务类型的逻辑概念,不同空间使用该空间唯一初始化时使用的推/播流域名,国标空间仅需要播放域名,用于管理空间内的设备、流,RTMP空间仅管理流)。

  2. 创建模板,包括截图、录制、时移、转码(仅应用在空间纬度)、AI模板(仅应用在流纬度)。

  3. 绑定模板,把模板应用到空间后,接入流后模板生效。可以在流纬度配置截图、录制、时移、AI模板。如果流已经接入,配置了时移、AI模板需要重新推流模板生效。