視圖計算產品說明,用于理解和使用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模板(僅應用在流緯度)。
綁定模板,把模板應用到空間后,接入流后模板生效??梢栽诹骶暥扰渲媒貓D、錄制、時移、AI模板。如果流已經接入,配置了時移、AI模板需要重新推流模板生效。