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