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