Agent DVR: 插件

安裝外掛程式

外掛程式是選用的附加模組,可透過額外的音訊和影片處理功能(例如條碼掃描、天氣覆蓋層和音訊濾波器)來擴充 Agent DVR 的功能。

最簡單的安裝外掛程式的方法是透過遠端網路入口網站。連線後,點擊右上角的伺服器圖示,並在系統下瀏覽至「外掛程式」。在此,您可以從右上角的下拉式選單中選擇要使用的外掛程式,然後點擊「安裝」以開始使用。

偏好手動安裝?沒問題!您可以從來源建置外掛程式 ,然後將建置的輸出複製到 Agent/Plugins/PLUGINNAME。此方法讓您對安裝程序有更多的控制權。

可用的外掛程式

Agent DVR 隨附強大的影片處理功能,例如 CodeProject AI 整合,以及進階的物件追蹤、音訊辨識和計數偵測器。為了進一步增強您的體驗,我們提供一系列外掛程式供您在 AgentDVR 中使用,以擴充其功能。

外掛程式清單

條碼

從攝影機掃描幾乎任何條碼 (僅限 Windows)。

引發的事件: 條碼已辨識
支援: 影片

螢幕擷取畫面

增益

在來自音訊裝置的音訊上套用即時頻帶濾波器。

引發的事件: 無
支援: 音訊

螢幕擷取畫面

即時延遲

為即時音訊和影片增加延遲 (適用於體育分析)。

引發的事件: 無
支援: 影片、音訊

螢幕擷取畫面

天氣

根據您的位置在即時影像上新增天氣狀態覆蓋層。如果天氣變化時引發事件 - 例如暴風雨來臨、風陣或溫度限制超過時。您可以自訂天氣資料的佈局和顯示模式,從僅圖示到完整詳細資訊。

天氣組態採用格式字串來排列資訊。以下是一些您可以使用的格式字串範例:

完整資訊:

{icon}{main}: {description} 
 風聲: {wind} 陣風: {gust} 
 溫度: {temp} 體感溫度: {feelsLike} 
 濕度: {humidity} UVI: {uvi}

僅圖示:

{icon}

單行:

{main} {wind} {temp} {humidity} UVI: {uvi}

引發的事件: 高溫、陣風、狀態
支援: 影片

螢幕擷取畫面
如果您在攝影機上使用像 Listen 這樣的音訊外掛程式,您需要編輯攝影機,選擇音訊標籤,然後點擊以設定麥克風。在此之後,您可以存取音訊裝置的外掛程式標籤。或者,您可以點擊伺服器圖示、編輯裝置,然後從該清單編輯麥克風。

設定外掛程式

準備好利用外掛程式的強大功能了嗎?只需新增一個裝置(攝影機和/或麥克風),然後進入其編輯設定。在右上角的下拉式選單中尋找外掛程式標籤。在這裡,您可以選擇所需的外掛程式,然後點擊「...」按鈕將其設定為符合您的需求。

某些外掛程式會觸發事件,您可以對其附加動作。例如,氣象外掛程式在陣風風速超過指定值(可在外掛程式中設定)時會觸發陣風事件。編輯攝影機並瀏覽至動作標籤可讓您選擇回應方式 - 例如觸發警報或開始錄影。只需在「時間」選擇方塊中選擇外掛程式名稱:事件(例如 Weather:Gust),然後指派動作。

建立您自己的外掛程式

外掛程式是動態模組,您可以新增至 Agent DVR 以增強其音訊和影片處理功能。透過外掛程式,在 Agent DVR 中套用即時效果、覆蓋層、觸發事件和警報,從而實現進階自訂動作。

若要開始為 Agent DVR 建立外掛程式,請先複製我們位於 https://github.com/ispysoftware/AgentDVR-Plugins 的開放原始碼外掛程式。您將需要最新版本的 Visual Studio 來建置它們。

我們建議以示範外掛程式作為基礎開始。確保您已安裝最新版本的 Agent。建置示範外掛程式後,將輸出資料夾中的所有檔案複製到 Agent\Plugins\Demo\。重新啟動 Agent DVR,編輯攝影機,並前往 外掛程式 標籤。啟用外掛程式,從下拉式功能表中選擇 Demo,然後按一下 "..." 按鈕進行設定。

Demo 外掛程式具有完全的跨平台相容性,展示了您可以使用外掛程式構建的廣泛功能。它包括即時影片效果、圖形覆蓋層、即時音量控制,以及與 Agent DVR 事件子系統的整合。外掛程式功能表提供了各種輸入控制項如何運作的深入了解。


開發人員外掛程式注意事項:

組態:Agent DVR 使用 JSON 和類別檔案進行設定儲存。若要設定設定,請編輯 config.cs 檔案。

Agent DVR 的組態轉譯依賴 .json 檔案。編輯 json 目錄中的 config_en.json 以顯示使用者介面,您可以在其中新增多個區塊以標籤形式呈現。json 中的 'bindto' 鍵欄位連結至組態欄位。Agent DVR 會自動化控制項轉譯、設定儲存和更新。

"live": true 新增至 json 項目可啟用立即更新,無需等待 OK 按鈕按一下,這對於即時效能調校非常有用。'converter' 欄位利用 Utils.cs 中的 'PopulateResponse' 來進行值格式化。

媒體支援:選擇處理 "video"、"audio" 或兩者。Main.cs 中的 'Supports' 欄位可以是硬編碼的。

連續處理:來自裝置的每個影片和音訊影格都會傳送至外掛程式進行分析或處理,如示範中所示。

移動偵測/警報處理:透過利用示範外掛程式中的 'ProcessEvent' 方法,在移動偵測或警報時處理影格。這允許僅在這些事件期間進行影格處理。

自訂事件:您外掛程式中的 'GetCustomEvents' 方法應傳回它產生的自訂事件清單。這些事件隨後會出現在 Agent DVR 使用者介面 '動作' 中的 'If' 清單下。使用 'Result' 項觸發這些事件,指定動作名稱和選擇性的 MSG、Tag、Filename 和 AIJSON。

警報、偵測和標籤:透過新增 eventName 為 "alert" 或 "detect" 的 Result 來觸發警報或偵測事件。使用 'tag' eventName 標籤進行中的錄影片段,並視需要設定標籤。

API 呼叫:Agent DVR 使用裝置資訊和本機伺服器連接埠初始化外掛程式,這對於裝置的 API 指令很有用。AppDataPath 和 AppPath 屬性也會設定用於顯示或檔案儲存位置。

發佈:建立了很酷或有用的外掛程式?與我們分享並為社群做出貢獻!