Agent DVRのアクションは、カメラ/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分後に発生）

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

利用できるアクションのリスト（Thenの下）は次のとおりです：

• アラート - デバイス上でアラートをトリガーします
• ビープ音 - ローカルPCスピーカーからビープ音を再生します
• URLの呼び出し - オプションの認証トークンを使用して任意のURLを呼び出します。ここでAgent 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}"

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

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}

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

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

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

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

タスクの設定方法:

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

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

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

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