設定: アクション

について

Agent DVRのアクションは、カメラ/AIのアラートやデバイスの切断など、特定のイベントに対する応答です。アクションにアクセスして設定するには、デバイスを編集し、メニューのアクションセクションに移動します。

新しいアクションを作成するには、「追加」をクリックします。以下の画像と似た構成画面が表示されます:

AIアクションインターフェース
AIタスクインターフェース

アクションをトリガーするイベントはさまざまです。各イベントに複数のアクションを関連付けることができ、これらのアクション内にさまざまなタグを組み込んで動的な応答を作成することができます。

アクションの設定
  • アクティブ: このオプションを切り替えてアクションを有効化または無効化します。または、上記のIDを使用してスケジュールAPIを使用して、actionOn、actionOff、およびactionRunのようなコマンドを使用することもできます。
  • もし: 利用可能なアクションを選択します(以下を参照)。
  • タグ付き:(AIイベント)。これは主にAIアクションと一緒に使用されます。たとえば、ここでAI: オブジェクトが見つかりましたを選択し、catを入力すると、アクションは猫が検出された場合にのみトリガーされます。
  • ゾーン内:(AIイベント)。検出されたオブジェクトをフィルタリングするために、モーション検出タブからモーションゾーンを指定します。たとえば、ゾーン1とタグcatを選択すると、アクションはゾーン1で猫が検出された場合にのみトリガーされます。すべてのゾーンを含めるには空白のままにします。
  • リピートタイムアウト: この間隔内でイベントが発生した場合、イベントは抑制され、タイマーがリセットされます。たとえば、トリガーが「車両が検出されました」として、30秒のタイムアウトを設定した場合、検出されたトラフィックに30秒の間隔があるまで、アラートは一度送信され、その後のアラートは一時停止されます。
  • タスクの追加: タスクを追加するにはクリックします。アクションに複数のタスクを割り当てることができます(v4.5.5.0以上)。

利用可能なアクション

アクションを設定できるイベントは以下の通りです:

  • AI: サーバーダウン(AIサーバーがエラーを返した場合 - リクエストが3回失敗し、サーバーがオンラインに戻るまで再発しない)
  • AI: サーバーアップ(AIサーバーがエラーステートを終了した場合)
  • AI: 顔認識
  • AI: 顔認識なし
  • AI: ライセンスプレート認識
  • AI: ライセンスプレート認識なし
  • AI: オブジェクト検出
  • AI: オブジェクト検出なし
  • AI: 音声認識(マイクのみ)
  • アラート
  • アラート終了
  • 手動アラート
  • モーション検出
  • モーション終了
  • なし - 「アラートアクション実行」コマンドでアクションをトリガーしたい場合はこれを使用します(スケジュールで設定)
  • ONVIF論理状態ON - 例えば、ONVIF論理状態の更新に基づいて録画を開始および停止する場合に使用します(モーション検出器のタイプをONVIFに設定する必要があります)
  • ONVIF論理状態OFF
  • 写真撮影
  • PTZプリセット適用
  • 再接続失敗
  • 録画終了
  • 録画開始
  • ソース切断
  • ソース再接続
  • デバイスオフに切り替え
  • デバイスオンに切り替え
  • システム: UI接続 - 誰かがシステムを表示するためにブラウザを開いた場合)
  • システム: UI切断 - セッションが閉じられた場合(ブラウザが切断されてからおおよそ1分後に発生)

監視員を検知

一定時間同じ場所に滞在する人や物を検出するには、以下の設定が必要です:

  • サーバー設定でAIサーバーを設定します
  • AI:滞在検出が検出されたときのためのアクションを追加します
  • 探しているタグを設定します。通常はpersonですが、車が長時間駐車されているのを検出する場合はcar、置き去りの荷物を検出する場合はsuitcase、ソファに座っているcatなども使用できます。複数のタグを使用することもできます、例:car,bus,truck。利用可能なオブジェクトのリストについては、カメラの編集時にオブジェクト認識のクラスリストを参照してください。
  • オブジェクトを探すべきゾーンを指定します。動きのゾーンを描画するためにディテクタータブを使用します。
  • ゾーン内に検出されたオブジェクトが許容される秒数を指定します。
  • 条件が満たされたときに実行するタスクを追加します。

カスタムイベントの追加

プリセットされたイベントを超えて、タスクを追加することでカスタムイベントを作成できます。タスクが作成されると、イベントリストに表示されます。その後、このタスクに応答するためのアクションを設定できます。タスクは、UIのライブページからトリガーすることができます(カメラを選択し、左下のタスクアイコンをクリックする)またはスケジュールで見つかるアクション:実行コマンドを介してトリガーすることができます。

カスタムタスク

タスクは、デバイスにアタッチできるコマンドで、手動でアクションをトリガーすることができます。アクションは、ドアを開けたり、ライトを点灯させたり、音を再生するなどのタスクを実行するために、サードパーティのAPIを呼び出すことができます。タスクを追加、削除、実行するには、ライブページでデバイスを選択し、タスクアイコン をクリックします。

タスクの設定方法:
  • タスクを説明するためのテキストを入力し、「+」ボタンをクリックします。OKをクリックします。
  • 編集アイコン を使用してデバイスを編集します。右上のメニューでエディタのアクションパネルを選択します。
  • アクションを追加します。条件として、先ほど作成したタスクを選択します(タスクは利用可能なアクションのリストの一番下に表示されます)その後、タスクが行う内容を設定します。
  • OKをクリックします。
  • ライブビューからこのアクションを手動でトリガーするには、タスクボタンをクリックし、タスクの横にあるGo矢印ボタンをクリックします。

また、Agent DVR APIを介してタスクをトリガーすることもできます。

利用可能なタスク

実行できる利用可能なアクションのリスト(Thenの下)は次のとおりです:

  • アラート - デバイス上でアラートをトリガーします
  • ビープ - ローカルPCスピーカーを通じてビープ音を再生します
  • プリセットに移動(PTZプリセット)
  • URLを呼び出す - オプションのAuthトークンを使用して任意のURLを呼び出します。ここでAgent DVR APIを呼び出すことができます。サーバー設定でProtect APIがチェックされている場合、認証ヘッダーを提供する必要があります。これを行うには、サーバー設定からユーザーアカウントを追加し、Basic Authヘッダーの値を入力する必要があります:
BASIC YWRtaW46YWRtaW4=
  • コマンドを実行
また、コマンドを参照してください。
独自のコマンド/スクリプトを追加するには、.batまたは.shファイルをCommandsディレクトリに追加できます。その後、バッチファイルにパラメータを渡すことができます。たとえば、すべての写真をDドライブのルートにコピーするには:

次の内容のプレーンテキストファイルを作成してください:
copy %1 D:\
copyPhoto.batとして保存してください(Linuxでは.shを使用します - このファイルをchmod +xを使用して実行可能にする必要があります)Agent Directory/Commandsに
次に、アクションを追加してください:
if: "写真が撮影された場合"
then: "コマンドを実行"
ファイル: copyPhoto
パラメータ: "{FILENAME}"

  • MQTT - MQTTメッセージを送信
  • MQTT Image - 生のライブ画像をjpegバイトでトピックに送信
  • ネットワークメッセージ
  • RTMP Start - このデバイスのRTMPストリーミングを開始
  • RTMP Stop - このデバイスのRTMPストリーミングを停止
  • メール送信(オプションで画像添付)
  • ビデオ付きメール送信(期間を指定 - これにはイベントのバッファが含まれます)。v4.9.8.0+
  • プッシュ通知の送信
  • SMSの送信
  • モーション検出エリアの設定(検出器で定義したエリアを選択)
  • メッセージの表示 - 閲覧用Webブラウザにメッセージを表示
  • サウンド(エージェントコンピュータ上)
  • サウンド(カメラ経由)
  • サウンド(Webブラウザ経由)
ブラウザのセキュリティ上、まずWebページとのやり取りが必要です(例:何かをクリックする)。これを回避するために、Chromeでchrome://settings/content/soundに移動し、サーバーのアドレス(またはリモートポータルを使用している場合は当社のウェブサイト)を許可リストに追加してください。
  • (あるデバイスで)録画を開始 - 停止するまで録画します。
  • RTMP ストリーミングを開始
  • (あるデバイスで)タイムラプスを開始
  • (あるデバイスで)録画を停止
  • RTMP ストリーミングを停止
  • (あるデバイスで)タイムラプスを停止
  • オブジェクトをオンに切り替え
  • オブジェクトをオフに切り替え
  • プロファイルを切り替え
  • テキスト読み上げ(Agent コンピューター上 - テキストはウェブサービスコールを介してレンダリングされるため、iSpyConnect.com アカウントが必要です)
  • ウェブブラウザーを介したテキスト読み上げ
ブラウザーのセキュリティ上、最初にウェブページとのやり取りが必要です(例:何かをクリックするなど)
  • テキスト読み上げ(カメラ経由)
  • 別のデバイスでアラートをトリガー
  • 別のデバイスで検出をトリガー
  • 別のデバイスで顔認識をトリガー
  • 別のデバイスでナンバープレート認識をトリガー
  • 別のデバイスで物体認識をトリガー
  • 別のデバイスで録画をトリガーします。これにより、録画タブのトリガー録画タイムアウト設定まで記録されます。このタイムアウトは、各トリガー録画アクション呼び出し毎にリセットされます。

タグの使用

Agent DVRのアクションのThenフィールド内のタグを使用すると、動的な応答を作成できます。ただし、一部のタグはコンテキストに依存します。たとえば、{FILENAME}はAlertイベントでは利用できず、{AI}はAIサーバーによって生成されなかった場合に利用できません。

  • {ID}: オブジェクトのID。Agentでカメラまたはマイクを編集する際に左上に表示されます。
  • {OT}: オブジェクトのタイプID。マイクの場合は1、カメラの場合は2。
  • {FILENAME}: ファイル名。Recording Started、Recording Finished、Snapshot Takenなどのイベントに適用されます。ファイルへの完全なローカルパスです。
  • {CURRENT_RECORDING}: 現在の録画のファイル名。ファイルへの完全なローカルパスです。 (v5.0.6.0+)
  • {MSG}: アクションをトリガーしたイベントの名前、例えば「Manual Alert」。
  • {NAME}: デバイスの名前(一般タブに表示されます)。
  • {GROUPS}: デバイスが所属するグループ(一般タブに表示されます)。
  • {LOCATION}: カメラの場所(一般タブに表示されます)。
  • {LEVEL} and {DB}: モーションまたは音声レベル。{DB}はオーディオデバイスのデシベルレベルです。アクションが実行された時に計測されます。 (v4.3.7.0+)
  • {AI}: AIから検出されたオブジェクトのカンマ区切りのリスト、LPRからのナンバープレート、または顔認識からの検出された顔。
  • {AIJSON}: DeepStackまたはLPRから返されるJSONデータ。
  • {ZONE}: アクションをトリガーしたゾーン(AIを使用していない場合は空、複数のゾーンの場合は1,2,3などのCSVリスト)。
  • {BASE64IMAGE}: ライブイメージのデータURL。生のbase64エンコードされたバイトであり、必要に応じてフォーマットしてください(例:
    p=data:image/jpeg;base64,{BASE64IMAGE}
    )。 (v4.5.9.0+で利用可能)

例えば、イベントAI: Face Recognizedに対して、ThenタスクのText to Speechにテキスト

Hello {AI}
を設定すると、認識された各人に名前で挨拶ができます。

アクションにトリガーアラートを設定する際には、サイクリックなルートを避けるために注意してください。たとえば、カメラ1のアラートがカメラ2のアラートをトリガーし、それが結果的にカメラ1のアラートをトリガーするような状況です。

アクションが追加されると、テーブルコントロールにアクションの概要が表示されます。緑のチェックマークはアクティブなアクションを示します。

アクションテーブルの例

スケジューラを使用してアクションを有効/無効にしたり、アクションをトリガーしたりすることができます。たとえば、特定の時間に2つの画像を添付したメールを送信するアクションをスケジュールで設定することができます。

アクションのスケジュール

この例では、2つの画像を添付したメールを送信するアクションが追加され、Noneイベントに設定されました。その後、スケジュールエントリが作成され、そのアクションが日曜日と土曜日の午前8時に実行されるように設定されました。