目次
概要
i-PRO カメラ用に開発されたサードパーティのカメラ拡張ソフトウェアは、Video Insight、Genetec、Milestone を備えた i-PRO Active Guard システムで使用できます。
i-PROアクティブガードについて詳しくはこちら
このドキュメントは、i-PRO カメラ拡張ソフトウェア開発者を対象としており、i-PRO Active Guard システムで動作する拡張ソフトウェアの実装方法、特に i-PRO カメラの API を使用した特定のデータ形式を対象としています。
開発者についての基本的な紹介はこちら
システムの構成と特長
VMS では次の機能が利用可能になります。
・VMS にイベントを表示します (日付/時刻、カメラ、イベント名、その他の詳細)
・ルールベースのアクションを設定する
・アラーム履歴の検索
i-PRO Active Guardシステム用拡張ソフトウェアの導入方法
適用できる拡張ソフトウェアの種類
何らかの付加情報を付加したイベント通知用拡張ソフトのみ適用可能です。 より高度な機能 (オブジェクトの分類やカウントなど) や関数 (境界ボックスなど) はサポートされていません。
サンプルアプリケーション
簡単に実装できるサンプルアプリケーションがSDKパッケージに含まれています。
src/adamapp/active_guard_sample_app
src/adamapp-py/active_guard_sample_app
使用するカメラAPI
i-PROカメラのAPI「AdamApp API」には、サードパーティがONVIF(*1)メタデータストリームプロトコルを介して外部ソフトウェアにイベントを通知するためのインターフェースが含まれています。
この統合には API「ADAM_MetaDataStream_SetRaw( ST_ADAM_METADATA_STREAM_RAW* pData )」が使用されます。 拡張ソフトウェアがイベントを検出し、この API を使用すると、データが i PRO Active Guard サーバーに送信され、i-PRO Active Guard サーバーも VMS サーバーに通知されます。
詳細については API マニュアルを参照してください。
(*1) : ONVIFはONVIF, Inc.の商標です。
E_ADAM_METADATA_TYPE
「ADAM_METADATA_TYPE_EVENT」は、i-PRO Active Guard の統合に使用されます。
m_pData
「m_pData」は、ONVIF で定義された XML データ形式でイベントを表す必要があります。 i-PRO Active Guardとの連携は、本書に記載のフォーマットに従って実装することで実現します。
通知例
<?xml version="1.0" encoding="UTF-8"?>
<tt:MetaDataStream xmlns:tt="http://www.onvif.org/ver10/schema" xmlns:wsnt="http://docs.oasis-open.org/wsn/b-2" xmlns:xsd="http://docs.onvif.org/ver10/schema">
<tt:Event>
<wsnt:NotificationMessage>
<wsnt:Topic Dialect="http://www.onvif.org/ver10/tev/topicExpression/ConcreteSet" xmlns:tns1="http://www.onvif.org/ver10/topics">tns1:AppEvent/SampleApplication/SampleDetection</wsnt:Topic>
<wsnt:Message>
<tt:Message UtcTime="2023-01-17T17:00:00.000Z">
<tt:Source>
<tt:SimpleItem Name="VideoSource" Value="VideoSourceConfig" />
</tt:Source>
<tt:Data>
<tt:SimpleItem Name="Event detail" Value="Detected size 84x120" />
<tt:SimpleItem Name="Likelihood” Value=“0.8" />
<tt:ElementItem Name="Image">
<xsd:base64Binary>(base64 encoded jpeg image)</xsd:base64Binary>
</tt:ElementItem>
</tt:Data>
</tt:Message>
</wsnt:Message>
</wsnt:NotificationMessage>
</tt:Event>
</tt:MetaDataStream>
Parameter Name | value | Description | Requirement Level |
|---|---|---|---|
Topic | tns1:AppEvent/{AppName}/{ EventName} | AppName: Application name. Event name: Event name. This name is shown on VMS. *App name is up to 256 characters using alpha-numeral, hyphen, under score and period as camera's SDK specification. App name is necessary to match "EXTAPP1"or"EXTAPP2"or ... in the response of "/cgibin/getinfo?FILE=1" from camera. | Mandatory |
tt:Message> UtcTime | yyyy-mm-ddThh:mm:ss.fffZ | Timestamp of the event in UTC format. *i-PRO Active Guard server will overwrite the time when receiving the event. | Mandatory |
tt:Message>tt:Data> tt:SimpleItem> Event Detail | string (up to 32 characters) | Additional information about the event. This value is shown on VMS | Optional |
tt:Message>tt:Data> tt:SimpleItem> Likelihood | 0.0-1.0 | Likelihood value related to the event. This value is shown on VMS. | Optional |
tt:Message>tt:Data> tt:ElementItem> Image | Base64 encoded jpeg image | (e.g. Cropped image of the detected object) This image is shown on VI and Milestone but not shown on Genetec. | Optional |
*If the application does not use “Event detail”, “Likelihood” and “Image”,<tt:Data> are no need.
実装の確認方法
適用できる拡張ソフトウェアの種類
実装後、カメラSDKパッケージに含まれるツール「ResourceMonitorExtension」を使用せずに、カメラが正しくデータを送信しているか確認することができます。 「RTSP-URI」に「rtsp://<ip>/Src/MediaInput/stream_1?event=1」と入力します。 この確認には VMS および i-PRO Active Guard ソフトウェアは必要ありません。 システムの設定方法は各VMSのi-PRO Active Guardセットアップマニュアルを参照してください。 付録では、i-PRO Active Guard サーバーおよび VMS での拡張ソフトウェアのセットアップ方法について説明します。