Agent DVR: プラグイン

プラグインのインストール

プラグインは Agent DVR を拡張する選択可能なアドオンモジュールで、バーコードスキャン、天気オーバーレイ、オーディオフィルターなどの追加オーディオおよびビデオ処理機能を提供します。

プラグインをインストールする最も簡単な方法は、リモートウェブポータルを使用することです。接続したら、右上の「サーバー」アイコンをクリックして、「システム」の下の「プラグイン」に移動します。ここで、右上のドロップダウンメニューから使用したいプラグインを選択し、「インストール」をクリックして開始できます。

手動でインストールしたいですか?問題ありません!ソースからプラグインをビルドして、ビルド結果を Agent/Plugins/PLUGINNAME にコピーできます。この方法は、インストール処理をより細かく制御できます。

利用可能なプラグイン

Agent DVR には、CodeProject AI 統合などの高度なビデオ処理機能が付属しており、高度なオブジェクト追跡、オーディオ認識、カウンティング検出器が備わっています。さらに体験を向上させるために、Agent DVR の機能を拡張するために使用できるさまざまなプラグインを提供しています。

プラグイン一覧

バーコード

カメラからほぼ全てのバーコードをスキャンできます (Windows のみ対応)。

発生するイベント: バーコード認識
対応: ビデオ

スクリーンショット

ゲイン

オーディオデバイスからのオーディオにライブバンドフィルターを適用します。

発生するイベント: なし
対応: オーディオ

スクリーンショット

ライブ遅延時間

ライブオーディオとビデオに遅延を追加します (スポーツ分析に便利)。

発生するイベント: なし
対応: ビデオ、オーディオ

スクリーンショット

天気

あなたの場所に基づいてライブビデオに天気ステータスオーバーレイを追加します。天気が変わったとき (例えば嵐が近づいているとき、または風速や気温の制限を超えたとき) にイベントを発生させます。アイコンのみから詳細表示まで、天気データのレイアウトと表示モードをカスタマイズできます。

天気の設定は、情報をレイアウトするためのフォーマット文字列を使用します。以下は使用可能なフォーマット文字列の例です:

完全な情報:

{icon}{main}: {description} 
 風: {wind} 突風: {gust} 
 気温: {temp} 体感気温: {feelsLike} 
 湿度: {humidity} UVI: {uvi}

アイコンのみ:

{icon}

1行表示:

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

発生するイベント: 高気温、突風、ステータス
対応: ビデオ

スクリーンショット
カメラで 聴取 などのオーディオプラグインを使用している場合、カメラを編集して「オーディオ」タブを選択し、マイクを構成するのをクリックする必要があります。そこからオーディオデバイスの「プラグイン」タブにアクセスできます。別の方法として、サーバーアイコンをクリックし、「デバイスの編集」を選択して、そのリストからマイクを編集することもできます。

プラグインの設定

プラグインの力を活用する準備はできていますか?デバイス(カメラまたはマイク)を追加して、その編集設定に進んでください。右上のドロップダウンにある「プラグイン」タブを探してください。ここで、目的のプラグインを選択し、「...」ボタンをクリックして、ニーズに合わせて構成できます。

一部のプラグインは、アクションを関連付けることができるイベントを発生させます。例えば、Weather プラグインは、突風が指定値を超えた場合に Gust イベントを発生させます(プラグインで構成可能)。カメラを編集して「アクション」タブに移動すると、これに対応するための選択肢が表示されます - 例えば警報を鳴らしたり、録画を開始したりします。単に「If」選択ボックスでプラグイン名: イベント(例: Weather: Gust)を選択して、アクションを割り当てます。

独自のプラグインを作成

プラグインは Agent DVR に追加できる動的モジュールで、オーディオおよびビデオ処理機能を強化します。プラグインを使用すると、リアルタイム エフェクト、オーバーレイを適用し、イベントを発生させ、Agent DVR でアラートをトリガーでき、高度なカスタム アクションが可能になります。

Agent DVR のプラグイン開発を始めるには、まずオープンソース プラグインを https://github.com/ispysoftware/AgentDVR-Plugins からクローンしてください。ビルドするには最新バージョンの Visual Studio が必要です。

デモ プラグインをベースとして開始することをお勧めします。最新バージョンの Agent がインストールされていることを確認してください。デモ プラグインをビルドした後、出力フォルダからすべてのファイルを Agent\Plugins\Demo\ にコピーしてください。Agent DVR を再起動して、カメラを編集し、プラグイン タブに移動します。プラグインを有効にして、ドロップダウンから Demo を選択し、「...」ボタンをクリックして構成します。

デモ プラグインは完全にクロスプラットフォーム対応で、プラグインで構築できる豊富な機能を示しています。ライブ ビデオ エフェクト、グラフィック オーバーレイ、ライブ ボリューム コントロール、および Agent DVR のイベント サブシステムとの統合が含まれています。プラグイン メニューは、さまざまな入力コントロールの動作方法に関する洞察を提供します。


開発者向けプラグイン メモ:

設定: Agent DVR は設定の保存に JSON とクラス ファイルを使用します。設定を構成するには、config.cs ファイルを編集してください。

Agent DVR の設定レンダリングは .json ファイルに依存します。UI 表示用に json ディレクトリの config_en.json を編集してください。ここでは複数のセクションをタブとしてレンダリングしたものを追加できます。json の「bindto」キー フィールドが設定フィールドにリンクされます。Agent DVR は自動的にコントロール レンダリング、設定の保存、および更新を実行します。

json エントリに "live": true を追加すると、OK ボタン クリックを待たずに即座に更新できるようになります。これはライブ チューニングに最適です。「converter」フィールドは Utils.cs の「PopulateResponse」を使用して値の形式を設定します。

メディア サポート: 「video」、「audio」、または両方を処理することを選択してください。Main.cs の「Supports」フィールドはハードコードできます。

常時処理: デバイスからのすべてのビデオおよびオーディオ フレームがプラグインに送信されて、分析または処理されます。デモに示されています。

モーション検知/アラート処理: デモ プラグインの「ProcessEvent」メソッドを利用して、モーション検知またはアラート時にフレームを処理します。これにより、これらのイベント中のみフレーム処理が可能になります。

カスタム イベント: プラグインの「GetCustomEvents」メソッドは、生成するカスタム イベントのリストを返す必要があります。これらのイベントは Agent DVR UI の「If」リスト内の「アクション」の下に表示されます。「結果」項目を使用してこれらのイベントをトリガーし、アクション名と、必要に応じて MSG、Tag、ファイル名、および AIJSON を指定します。

アラート、検出、タグ: eventName を「alert」または「detect」として「結果」を追加することで、アラートを発生させたり、イベントを検出したりします。eventName を「tag」として進行中の録画ファイルにタグを付け、必要に応じてタグを設定します。

API 呼び出し: Agent DVR はデバイス情報およびローカルサーバー ポートでプラグインを初期化し、デバイスへの API コマンドに便利です。プロパティ AppDataPath および AppPath も表示用またはファイル保存場所用に設定されます。

配布: クールまたは便利なプラグインを作成しましたか? ぜひ共有してください コミュニティに貢献してください。