Cấu hình: Hành động

Về

Actions (Hành động) trong Agent DVR là những phản hồi đối với các sự kiện cụ thể, như cảnh báo camera/AI hoặc ngắt kết nối thiết bị. Sử dụng chúng để phản hồi tự động, ví dụ như phát báo động, bật đèn qua ổ cắm thông minh bằng URL, hoặc kích hoạt ghi hình trên camera khác. Để truy cập và cấu hình Actions, chỉnh sửa thiết bị và điều hướng đến phần Actions trong menu.

Nhấp 'Add' để tạo hành động mới. Bạn sẽ thấy màn hình cấu hình tương tự như hình ảnh dưới đây:

AI Actions Interface
AI Task Interface

Có rất nhiều sự kiện có thể kích hoạt các hành động. Nhiều hành động có thể được liên kết với mỗi sự kiện, và bạn có thể kết hợp các thẻ khác nhau trong những hành động này để tạo phản hồi động.

Cấu hình một Hành động

  • Active: Bật tắt để kích hoạt hoặc vô hiệu hóa hành động. Hoặc, bạn có thể sử dụng ScheduleAPI với các lệnh như actionOn, actionOff, và actionRun, sử dụng ID hiển thị ở trên.
  • Name: Tên tùy chọn cho hành động.
  • If: Chọn một sự kiện khả dụng (xem bên dưới).
  • With tag: (AI Events). Chủ yếu được sử dụng với các sự kiện AI. Ví dụ, nếu bạn chọn AI: Object Found và nhập cat ở đây, hành động sẽ kích hoạt chỉ khi phát hiện được mèo. Lưu ý rằng thẻ khớp dựa trên ngôn ngữ được chọn trong Server Settings - General.
  • Rule: Chọn xem nhiều thẻ phải khớp tất cả (AND) hay có thể khớp bất kỳ (OR).
  • In Zones: (AI Events). Chỉ định các vùng chuyển động (từ tab phát hiện chuyển động) để lọc các đối tượng phát hiện được. Ví dụ, chọn vùng 1cat làm thẻ, hành động sẽ chỉ kích hoạt khi phát hiện được mèo trong vùng 1. Để trống để bao gồm tất cả các vùng.
  • Repeat Timeout: Điều này loại bỏ sự kiện nếu nó đã được phát sinh trong khoảng thời gian này và cũng đặt lại bộ đếm thời gian. Ví dụ, với 'Vehicle detected' làm trigger và timeout 30 giây, một cảnh báo sẽ được gửi một lần, với các cảnh báo tiếp theo tạm dừng cho đến khi có khoảng cách 30 giây trong lưu lượng phát hiện được.
  • Add Task: Nhấp để thêm tác vụ. Bạn có thể gán nhiều tác vụ cho một hành động (v4.5.5.0+).

Các Hành động Có sẵn

Hành động có thể phản ứng với một loạt sự kiện hệ thống, thiết bị và AI. Các sự kiện bạn có thể thiết lập hành động cho là:

  • AI Server Down (AI Server đã trả về lỗi - sự kiện sẽ kích hoạt sau khi yêu cầu thất bại 3 lần và sẽ không lặp lại cho đến khi máy chủ trở lại hoạt động)
  • AI Server Up (AI Server đã thoát khỏi trạng thái lỗi)
  • AI: Ask AI Positive Result (Nó đã tìm thấy đối tượng bạn đang tìm kiếm)
  • AI: Ask AI Result (kích hoạt trên bất kỳ phản hồi Ask AI nào, dương tính hay không)
  • AI: Describe Response Received (Một hình ảnh được mô tả bởi AI - mô tả nằm trong thẻ {MESSAGE} và {AIJSON})
  • AI: Face Recognized
  • AI: Face Not Recognized
  • AI: License Plate Recognized
  • AI: License Plate Not Recognized
  • AI: Loiter Detected
  • AI: Object Found
  • AI: Object Not Found
  • AI: Sound Recognized (chỉ mic)
  • Alert
  • Alert Finished
  • Call URL Response Received - Điều này được kích hoạt bởi phản hồi bạn nhận được khi tác vụ "Call URL" chạy, cho phép bạn phản hồi với các tác vụ khác.
  • Manual Alert
  • Motion Detected
  • Motion Finished
  • None - sử dụng nếu bạn muốn kích hoạt hành động tự mình bằng lệnh "Action: Run" trên schedule
  • ONVIF Event ON - sử dụng cái này để ví dụ bắt đầu và dừng ghi lại dựa trên cập nhật trạng thái logic ONVIF (yêu cầu loại bộ phát hiện chuyển động được đặt thành ONVIF)
  • ONVIF Event OFF
  • ONVIF Event Received (kích hoạt trên bất kỳ sự kiện ONVIF nào từ camera)
  • Photo Taken
  • PTZ Preset Applied
  • Reconnect Failed
  • Recording Failed
  • Recording Finished
  • Recording Started
  • Source Disconnected
  • Source Reconnected
  • Source Covered/ Tampered
  • Switch Device Off
  • Switch Device On
  • System: Armed
  • System: Disarmed
  • System: No UI Connected - khi phiên UI cuối cùng đóng lại
  • System: Profile Applied
  • System: UI Connected - khi ai đó mở trình duyệt để xem hệ thống của bạn
  • System: UI Disconnected - khi phiên được đóng lại (xảy ra khoảng một phút sau khi trình duyệt ngắt kết nối)
  • Timelapse Started
  • Timelapse Stopped

Bất kỳ sự kiện plugin nào và tác vụ tùy chỉnh mà bạn đã thêm cũng xuất hiện ở cuối danh sách này.

Phát hiện lảng thờ.

Để phát hiện loitering (người hoặc vật thể ở lại một chỗ trong một khoảng thời gian nhất định) bạn cần cấu hình như sau:

  • Thiết lập một AI server trong cài đặt máy chủ
  • Thêm một Action cho AI: Loiter Detected
  • Đặt tag bạn đang tìm kiếm - thường là person nhưng bạn có thể sử dụng car để phát hiện ô tô đỗ trong một khu vực quá lâu hoặc suitcase cho hành lý bị bỏ lại hoặc một con cat ngồi trên ghế sofa của bạn. Bạn có thể sử dụng nhiều tag ở đây ví dụ như car,bus,truck. Để xem danh sách các vật thể có sẵn cần tìm hãy xem danh sách classes trong nhận dạng vật thể khi bạn chỉnh sửa camera.
  • Chỉ định các zone bạn muốn tìm vật thể. Sử dụng tab detector để vẽ các motion zones.
  • Chỉ định số giây bạn sẽ cho phép vật thể được phát hiện ở trong zone.
  • Thêm Tasks để thực hiện khi các điều kiện được đáp ứng.

Lưu ý: Loiter detector sử dụng các cài đặt từ object recognition settings như check corners và overlay

Thêm Sự kiện Tùy chỉnh

Ngoài các sự kiện được thiết lập sẵn, bạn có thể tạo sự kiện tùy chỉnh bằng cách thêm Nhiệm vụ. Khi một nhiệm vụ được tạo, nó sẽ xuất hiện trong danh sách Sự kiện. Sau đó, bạn có thể thiết lập một Hành động để phản ứng với nhiệm vụ này. Nhiệm vụ có thể được kích hoạt từ trang Trực tiếp trong Giao diện người dùng (bằng cách chọn một camera và sau đó nhấp vào biểu tượng nhiệm vụ ở góc dưới bên trái) hoặc thông qua lệnh Hành động: Chạy được tìm thấy trong Lịch trình.

Nhiệm vụ Tùy chỉnh

Công việc là các lệnh bạn có thể gán cho thiết bị để kích hoạt Hành động thủ công. Hành động có thể gọi các API bên thứ ba để thực hiện các công việc như mở cửa, bật đèn, phát âm thanh, v.v. Để thêm, xóa và thực thi công việc, chọn một thiết bị trên trang Trực tiếp và nhấp vào biểu tượng công việc .

Thiết lập một công việc:

  • Nhập một số văn bản để mô tả công việc, ví dụ "Bật đèn" và nhấp vào nút +. Nhấp OK
  • Nhấp để chỉnh sửa thiết bị bằng cách sử dụng biểu tượng chỉnh sửa . Chọn bảng Hành động trong biên tập viên bằng menu ở góc trên bên phải.
  • Thêm một hành động. Chọn điều kiện "Nếu" là công việc bạn vừa tạo (công việc được hiển thị ở cuối danh sách các hành động có sẵn) và sau đó cấu hình công việc bạn muốn thực hiện.
  • Nhấp OK
  • Bây giờ bạn có thể kích hoạt hành động này thủ công từ chế độ xem trực tiếp bằng cách nhấp vào nút công việc và nhấp vào nút mũi tên Đi kèm với công việc.

Bạn cũng có thể kích hoạt công việc thông qua API Agent DVR.

Công việc có sẵn

Các tác vụ là những hành động mà một sự kiện thực hiện khi nó được kích hoạt, từ gửi cảnh báo email hoặc thông báo đẩy đến kiểm soát ghi hình trên các thiết bị khác. Danh sách các tác vụ có sẵn mà bạn có thể thực hiện (dưới Sau đó) là:

  • Cảnh báo - kích hoạt cảnh báo trên thiết bị
  • Beep - phát âm thanh cảnh báo qua loa của máy tính Agent DVR
  • Gọi URL - gọi bất kỳ URL nào với token xác thực tùy chọn. Bạn có thể gọi Agent DVR API tại đây hoặc gửi cảnh báo đến Discord, Slack, ntfy và các dịch vụ tương tự (xem Webhooks). Nếu bạn đã chọn Protect API trong cài đặt máy chủ, bạn sẽ cần cung cấp tiêu đề xác thực. Để làm điều này, bạn sẽ cần thêm Tài khoản Người dùng qua Cài đặt Máy chủ và nhập giá trị Basic Auth Header:
BASIC YWRtaW46YWRtaW4=
  • Thực hiện Lệnh
Xem thêm lệnh
Để thêm các lệnh/script của riêng bạn, bạn có thể thêm các tệp .bat hoặc .sh vào thư mục Commands. Sau đó, bạn có thể truyền các tham số vào tệp batch. Ví dụ, để sao chép tất cả các ảnh vào thư mục gốc của ổ D:

Tạo một tệp văn bản thuần chứa:

copy %1 D:\

Lưu nó dưới dạng copyPhoto.bat (trên linux sử dụng .sh - bạn sẽ cần tạo tệp này có thể thực thi bằng chmod +x) vào Agent/Commands
Sau đó thêm một hành động:
if: "Photo Taken"
then: "Execute Command"
File: copyPhoto
Parameters: "{FILENAME}"

  • Tải lên ghi hình hiện tại lên cloud - tải lên ghi hình hiện tại đến nhà cung cấp cloud của thiết bị
  • Trì hoãn - tạm dừng trước khi chạy tác vụ tiếp theo
  • Bật / Tắt Ask AI
  • Bật / Tắt Nhận dạng Khuôn mặt
  • Bật / Tắt LPR
  • Bật / Tắt Nhận dạng Vật thể
  • Bật / Tắt Patrol On (PTZ tuần tra trên thiết bị)
  • Bật / Tắt Nhận dạng Âm thanh
  • Tải lên ghi hình hiện tại lên FTP - tải lên ghi hình hiện tại đến máy chủ FTP của thiết bị
  • Ghi nhật ký - ghi một tin nhắn vào nhật ký Agent DVR
  • MQTT - gửi một tin nhắn MQTT
  • Ảnh MQTT - gửi một ảnh động trực tiếp ở định dạng jpeg bytes đến một chủ đề
  • Thông báo Mạng
  • Lệnh PTZ - di chuyển camera đến một cài đặt trước hoặc chạy một lệnh PTZ
  • Gửi Email (với các tệp đính kèm hình ảnh tùy chọn)
  • Gửi Email có Video (chỉ định thời lượng - điều này bao gồm một bộ đệm của sự kiện). v4.9.8.0+
  • Gửi Thông báo Đẩy
  • Gửi SMS
  • Đặt Khu vực Bộ phát hiện Chuyển động (chọn Khu vực bạn đã xác định trên Bộ phát hiện)
  • Hiển thị Thông báo - hiển thị thông báo trên trình duyệt web đang xem
  • Âm thanh (trên máy tính Agent DVR)
  • Âm thanh (qua camera)
  • Âm thanh (qua trình duyệt web)
Do bảo mật của trình duyệt, điều này yêu cầu tương tác với trang web trước (ví dụ: nhấp vào một thứ gì đó). Để khắc phục sự cố này trong chrome, hãy vào chrome://settings/content/sound và thêm địa chỉ máy chủ của bạn (hoặc trang web của chúng tôi nếu bạn đang sử dụng cổng thông tin từ xa) vào Danh sách Được phép.
  • Bắt đầu Ghi hình Trên (một số thiết bị) - sẽ ghi hình cho đến khi dừng.
  • Bắt đầu Phát trực tiếp RTMP
  • Bắt đầu Timelapse Trên (một số thiết bị)
  • Dừng Ghi hình Trên (một số thiết bị)
  • Dừng Phát trực tiếp RTMP
  • Dừng Timelapse Trên (một số thiết bị)
  • Switch Device On
  • Switch Device Off
  • Hệ thống: Áp dụng Hồ sơ - chuyển Hồ sơ
  • Hệ thống: Vũ trang
  • Hệ thống: Giải vũ trang
  • Ghi nhãn Ghi hình - thêm một nhãn vào ghi hình hiện tại
  • Chụp Ảnh Trên (một số thiết bị)
  • Văn bản sang Giọng nói (trên máy tính Agent DVR - yêu cầu tài khoản iSpyConnect.com vì văn bản được kết xuất qua các lệnh gọi dịch vụ web)
  • Văn bản sang Giọng nói (qua trình duyệt web)
Do bảo mật của trình duyệt, điều này yêu cầu tương tác với trang web trước (ví dụ: nhấp vào một thứ gì đó)
  • Văn bản sang Giọng nói (qua camera)
  • Kích hoạt Mã hóa Thích ứng Trên (thiết bị khác)
  • Kích hoạt Cảnh báo Trên (thiết bị khác)
  • Kích hoạt Ask AI (thiết bị khác)
  • Kích hoạt Nhận dạng Âm thanh (thiết bị khác)
  • Kích hoạt Detect On (thiết bị khác)
  • Kích hoạt Face Recognition (thiết bị khác)
  • Kích hoạt LPR (thiết bị khác)
  • Kích hoạt Object Recognition (thiết bị khác)
  • Kích hoạt Recording (với timeout) (thiết bị khác). Sẽ ghi âm lên đến cài đặt trigger recording timeout trên tab Recording. Timeout này được đặt lại với mỗi lệnh kích hoạt ghi âm.
  • UI: Change View - chuyển các UI được kết nối sang một chế độ xem khác

Sử dụng Thẻ

Các thẻ trong các trường Then của các hành động Agent DVR cho phép bạn tạo các phản hồi động. Điều quan trọng cần lưu ý là một số thẻ phụ thuộc vào ngữ cảnh. Ví dụ, {FILENAME} không khả dụng cho Alert Events, và {AI} không khả dụng nếu sự kiện không được tạo bởi máy chủ AI.

  • {ID}: ID của đối tượng, hiển thị ở góc trên bên trái của trình chỉnh sửa khi chỉnh sửa camera hoặc micro trong Agent.
  • {OT}: ID loại đối tượng. 1 cho Microphone, 2 cho Camera.
  • {FILENAME}: Tên tệp. Áp dụng cho các sự kiện như Recording Started, Recording Finished, và Snapshot Taken. Đây là đường dẫn cục bộ đầy đủ của tệp.
  • {CURRENT_RECORDING}: Tên tệp của bản ghi hiện tại. Đường dẫn cục bộ đầy đủ của tệp. (v5.0.6.0+)
  • {MESSAGE}: Tên của sự kiện đã kích hoạt hành động, ví dụ "Manual Alert".
  • {EVENT}: Loại sự kiện.
  • {NAME}: Tên của thiết bị (có trên tab General).
  • {GROUPS}: Các nhóm mà thiết bị thuộc về (có trên tab General).
  • {SERVER}: Tên máy chủ (từ Server Settings).
  • {ALERTID}: ID của alert (-1 nếu không có alert liên kết).
  • {ALERTCOUNT}: Số lượng alert của thiết bị.
  • {TIME} và {DATE}: Thời gian và ngày hiện tại trên máy chủ.
  • {RECORDED}: "REC" nếu thiết bị đang ghi âm, ngoài ra để trống.
  • {TAGS}: Các thẻ liên kết với sự kiện.
  • {PLUGIN}: Thông báo từ một sự kiện plugin.
  • {LOCATION}: Vị trí của camera (có trên tab General).
  • {LEVEL} và {DB}: Mức chuyển động hoặc âm thanh. {DB} là mức decibel cho các thiết bị âm thanh. Được đo lường khi hành động chạy. (v4.3.7.0+)
  • {AI}: Danh sách các đối tượng được phát hiện từ AI, biển số từ LPR, hoặc các khuôn mặt được phát hiện từ Facial Recognition, được phân tách bằng dấu phẩy.
  • {AIJSON}: Dữ liệu JSON được trả về từ AI hoặc LPR.
  • {ZONE}: Vùng đã kích hoạt hành động (để trống nếu không sử dụng AI hoặc danh sách CSV cho nhiều vùng như 1,2,3).
  • {BASE64IMAGE}: URL dữ liệu hình ảnh trực tiếp. Đây là các byte được mã hóa base64 thô, vì vậy định dạng khi cần thiết ví dụ như
    p=data:image/jpeg;base64,{BASE64IMAGE}
    (Available v4.5.9.0+). Hình ảnh trực tiếp được thay đổi kích thước thành 640px chiều rộng.
  • {BASE64IMAGE-LG}: URL dữ liệu hình ảnh trực tiếp. Đây là các byte được mã hóa base64 thô, vì vậy định dạng khi cần thiết ví dụ như
    p=data:image/jpeg;base64,{BASE64IMAGE-LG}
    (Available v6.0.8.0+). Hình ảnh trực tiếp được thay đổi kích thước thành 1280px chiều rộng.
  • {BASE64IMAGE-NATIVE}: URL dữ liệu hình ảnh trực tiếp. Đây là các byte được mã hóa base64 thô, vì vậy định dạng khi cần thiết ví dụ như
    p=data:image/jpeg;base64,{BASE64IMAGE-NATIVE}
    (Available v6.0.8.0+). Hình ảnh trực tiếp gốc.

Ví dụ, với một sự kiện AI: Face Recognized, một nhiệm vụ ThenText to Speech với văn bản

Hello {AI}
sẽ chào mỗi người được nhận ra theo tên.

Lưu ý: Nếu bạn sử dụng các thẻ {BASE64IMAGE} với một sự kiện liên quan đến tệp như "Photo Taken", nó sẽ sử dụng hình ảnh kích thước đầy đủ từ tệp. Ngoài ra, nó sẽ thay đổi kích thước hình ảnh chế độ xem trực tiếp hiện tại.

Hãy thận trọng với các alert kích hoạt trên hành động để tránh các tuyến đường tuần hoàn, ví dụ alert trên Camera 1 kích hoạt alert trên Camera 2, lần lượt kích hoạt alert trên Camera 1.

Sau khi thêm một hành động, điều khiển bảng sẽ hiển thị tóm tắt các hành động của bạn. Một dấu kiểm xanh cho biết hành động đang hoạt động.

Example Action Table

Bạn có thể sử dụng scheduler để bật/tắt hành động hoặc kích hoạt một hành động. Ví dụ, bạn có thể lên lịch một hành động gửi email với hai hình ảnh vào một thời gian cụ thể.

Schedule Actions

Trong ví dụ này, một hành động đã được thêm để gửi email với 2 hình ảnh, được đặt thành sự kiện None. Sau đó, một mục lịch biểu được tạo để thực thi hành động đó lúc 8AM vào Chủ nhật và Thứ bảy.