Tích hợp
Ứng dụng di động
Các ứng dụng di động của chúng tôi cho phép bạn kết nối qua mạng LAN hoặc thông qua các dịch vụ từ xa của chúng tôi. Chúng có sẵn cho cả thiết bị Android và iOS.
Tải xuống Ứng dụng Agent DVR Remote cho Android .
Tải xuống Ứng dụng Agent DVR Remote cho iOS .
Bao bọc Python
Có một bọc python cho chức năng giao diện người dùng cơ bản ở đây: agent-py .
Tham số URL
Bạn có thể mở Agent đến một chế độ xem cụ thể bằng cách gọi url Agent DVR với (phân biệt chữ hoa chữ thường):
- ?start=Live&viewIndex=3 (chế độ xem trực tiếp trên chế độ xem 3)
- ?start=TimeMachine (chế độ xem máy thời gian)
- ?start=Timeline (chế độ xem dòng thời gian)
- ?start=Photos (chế độ xem ảnh)
- ?start=Recordings (chế độ xem ghi lại)
- ?start=Floorplans&planIndex=2 (chế độ xem bản đồ tầng trên bản đồ 2)
- ?start=VR (thực tế ảo)
Bạn có thể mở Agent DVR với một ngôn ngữ cụ thể (bỏ qua việc chọn ngôn ngữ). Chỉ cần truyền vào mã ngôn ngữ 2 ký tự: ?lang=fr
Bạn có thể truyền vào tên của bộ lọc đã lưu để áp dụng bằng cách sử dụng tham số bộ lọc - ví dụ: ?start=Recordings&filter=intruder. Bạn cũng có thể truyền vào thời gian bắt đầu và kết thúc cho bộ lọc bằng cách sử dụng dấu thời gian javascript. ví dụ ?start=timeline&from=1657841514949&to=1657852514949.
Thiết lập các tùy chọn chủ đề mặc định (các tùy chọn chủ đề có sẵn trong menu tài khoản - cài đặt chủ đề):
- ?theme=darkly&variant=dark&large=false
- ?theme=sketchy&variant=primary&large=true
Tự động phát âm thanh khi tải (có thể cần thay đổi cài đặt trình duyệt):
- ?playaudio=true
Bắt đầu ở chế độ thu nhỏ (thanh UI trên và dưới bị ẩn):
- ?mini=true
Truyền vào tên người dùng và mật khẩu địa phương để đăng nhập tự động (cảnh báo - điều này sẽ tiết lộ thông tin đăng nhập của bạn cho mạng):
- ?un=username&pwd=password
Lệnh
Để truy cập các Lệnh trong Agent DVR, nhấn vào biểu tượng Máy chủ ở góc trên bên trái của Giao diện người dùng Agent, và chọn "Commands" dưới mục Hệ thống. Một phím tắt nhanh là nhấn "Alt - C".
Agent DVR bao gồm một số lệnh được xây sẵn có thể điều khiển nhiều thiết bị đồng thời. Các lệnh này sử dụng API để thực hiện các nhiệm vụ khác nhau. Bạn có linh hoạt để thêm các lệnh tùy chỉnh của riêng mình để gọi API hoặc chạy phần mềm trên máy tính của bạn.
Gọi một Tập lệnh
Để thực thi một tập lệnh chung, chỉ cần thêm một tập tin .bat (hoặc .sh trên Linux/macOS) vào thư mục lệnh. Tên tập lệnh (không có phần mở rộng) sẽ xuất hiện trong danh sách Lệnh và có thể được nhấp để chạy. Lưu ý: Bạn có thể cần tải lại Giao diện người dùng để nó hiển thị.
Gọi API
Tạo một tập tin .bat mới trong thư mục Lệnh nơi Agent được cài đặt. Dòng đầu tiên nên là:
REM ispy-internal
Dòng này cho biết rằng tập tin sẽ được xử lý bên trong bởi Agent, không được thực thi như một ứng dụng độc lập.
Các dòng tiếp theo được hiểu là các lệnh cho API của Agent. Ví dụ:
REM ispy-internal
switchon&group=external
switchoff&group=internal
record&group=external
broadcast 'external cameras are on and recording'
Các lệnh này được thêm vào cuộc gọi API theo định dạng /command.cgi?cmd=.... Do đó, bạn có thể sử dụng bất kỳ lệnh nào có sẵn trong API.
Các lệnh ví dụ ở trên sẽ kích hoạt tất cả thiết bị được gắn nhãn là "external", tắt tất cả thiết bị "internal", bắt đầu ghi âm trên các thiết bị "external", và gửi một tin nhắn phát sóng đến tất cả các máy khách kết nối.
Tham khảo nút lệnh readme để xem ví dụ và tài liệu API để xem danh sách các lệnh có sẵn.
Sau khi tải lại Giao diện người dùng và nhấn "Alt - C", lệnh mới của bạn sẽ xuất hiện trong danh sách. Nhấp vào để thực thi.
Từ phiên bản 3.8.1.0+, bạn có thể sử dụng tên vị trí trong các lệnh (ví dụ, switchon&location=home). Chỉ cần gán một vị trí cho các thiết bị của bạn trước!
Amazon Alexa
Từ phiên bản 2.9.5.0, Agent DVR cung cấp tích hợp Amazon Alexa. Tính năng này cho phép bạn điều khiển Agent DVR bằng lệnh giọng nói thông qua các thiết bị hỗ trợ Alexa. Bạn có thể bật hoặc tắt hệ thống hoặc hiển thị video trực tiếp trên các thiết bị Alexa Show.
Để thiết lập, chọn 'Alexa' dưới phần Tích hợp trong menu Máy chủ của Agent DVR. Điều này sẽ chuyển bạn đến Amazon để liên kết các tài khoản của bạn.
Sau khi liên kết, chạy quy trình khám phá của Alexa. Nó sẽ tìm thấy hai thiết bị: bảng điều khiển an ninh và điều khiển camera.
Bây giờ bạn có thể sử dụng các lệnh giọng nói như:
- "Alexa, bật Agent ở chế độ nhà"
- "Alexa, hiển thị camera Agent"
Đặt mã bảo mật của bạn trong Cài đặt Agent cho các hoạt động yêu cầu xác thực. Mã mặc định là 1234.
Các hồ sơ Alexa (Nhà / Ra ngoài / Ban đêm) tương ứng với các hồ sơ trong Agent DVR. Cấu hình chúng trong Máy chủ - Hồ sơ.
Đối với nhiều máy chủ, đặt tên máy chủ trong cài đặt và sử dụng nó trong các lệnh giọng nói.
Trợ lý Nhà ở
Agent DVR hoàn toàn tích hợp với Home Assistant, cho phép bạn thêm Agent DVR vào cài đặt Home Assistant của mình. Nhúng bảng điều khiển Agent DVR vào giao diện lovelace UI hoặc chọn từng camera cá nhân. Nó cũng bao gồm điều khiển cho bảng điều khiển bảo mật chính. Để biết thêm thông tin, xem liên kết Home Assistant dưới mục Server - Integrations.
IFTTT (Nếu Điều Này Thì Điều Kia)
IFTTT cho phép bạn thiết lập các hành động và kích hoạt với các thiết bị IoT. Bắt đầu bằng cách kết nối tài khoản IFTTT của bạn với iSpyConnect.com, có thể truy cập dưới mục Máy chủ - Tích hợp.
Đẩy Cảnh báo
Thiết lập cảnh báo đẩy trên di động được mô tả chi tiết tại Thiết lập Cảnh báo Đẩy.
Telegram
Kết nối Agent DVR với chatbot Telegram để điều khiển và nhận thông báo cảnh báo trực tiếp. Bật Thông báo Đẩy trong cài đặt thiết bị để nhận thông báo trực tiếp. Bắt đầu bằng cách chọn nút Telegram dưới biểu tượng Máy chủ trong giao diện web từ xa.
Webhook (Discord, Slack và hơn thế nữa)
Agent DVR có thể gửi cảnh báo đến bất kỳ dịch vụ nào chấp nhận webhook đến, bao gồm Discord, Slack, Mattermost, Google Chat, Microsoft Teams và ntfy. Không cần liên kết tài khoản: bạn tạo một URL webhook trong dịch vụ đích và Agent DVR gửi cảnh báo trực tiếp đến đó, vì vậy cách này cũng hoạt động trên các máy chủ không có truy cập từ xa.
Cách thiết lập chung giống nhau cho mọi dịch vụ. Chỉnh sửa camera hoặc micrô của bạn, mở thẻ Hành động và thêm một hành động:
- Nếu: Cảnh báo (hoặc bất kỳ sự kiện nào khác)
- Thì: Gọi URL
- URL: URL webhook từ dịch vụ
- Phương pháp: POST
- Body (nội dung): tin nhắn, theo định dạng cho từng dịch vụ bên dưới
Bạn có thể dùng các thẻ như {NAME}, {MESSAGE}, {AI} và {ZONE} trong trường Body để tạo tin nhắn động.
Content-Type: application/json
Discord
Trong Discord, mở cài đặt kênh (biểu tượng bánh răng) và chọn Tiện ích tích hợp - Webhook - Webhook mới, sau đó Sao chép URL webhook. Trong hành động của Agent DVR, dùng:
- URL: URL webhook đã sao chép
- Body:
{"content":"{MESSAGE}: {NAME} trên {SERVER} {AI}"}
Để đính kèm ảnh chụp vào tin nhắn Discord, đặt thanh trượt Tải ảnh lên thành 1 trở lên (v7.8.7.0+). Mỗi ảnh tiếp theo được chụp cách nhau nửa giây.
Slack
Tạo ứng dụng Slack tại api.slack.com/apps, bật Incoming Webhooks, nhấp Add New Webhook to Workspace, chọn kênh và sao chép URL (bắt đầu bằng hooks.slack.com). Trong hành động của Agent DVR, dùng:
- URL: URL webhook đã sao chép
- Body:
{"text":"{MESSAGE}: {NAME} trên {SERVER} {AI}"}
Webhook đến của Slack chỉ hỗ trợ văn bản, vì vậy hãy để Tải ảnh lên ở mức 0.
Mattermost
Trong Mattermost, vào Menu chính - Tích hợp - Webhook đến - Thêm webhook đến, chọn kênh và sao chép URL. Dùng cùng định dạng Body như Slack:
{"text":"{MESSAGE}: {NAME} trên {SERVER}"}
Google Chat
Trong một không gian Google Chat (tài khoản Workspace), nhấp vào tên không gian và chọn Ứng dụng và tiện ích tích hợp - Webhook - Thêm webhook, sau đó sao chép URL. Dùng cùng định dạng Body như Slack:
{"text":"{MESSAGE}: {NAME} trên {SERVER}"}
Microsoft Teams
Trong Teams, nhấp vào ba dấu chấm cạnh kênh, chọn Quy trình làm việc và thêm mẫu Đăng lên kênh khi nhận được yêu cầu webhook, sau đó sao chép URL được cấp. Teams yêu cầu tin nhắn ở dạng Adaptive Card:
{"type":"message","attachments":[{"contentType":"application/vnd.microsoft.card.adaptive","content":{"type":"AdaptiveCard","version":"1.4","body":[{"type":"TextBlock","text":"{MESSAGE}: {NAME} trên {SERVER}","wrap":true}]}}]}
ntfy
ntfy gửi thông báo đẩy đến điện thoại của bạn mà không cần tài khoản, và cũng có thể tự lưu trữ. Chọn một tên chủ đề khó đoán (bất kỳ ai biết tên đều có thể đăng ký theo dõi), sau đó:
- URL: https://ntfy.sh/ten-chu-de-cua-ban
- Body: văn bản thuần (không phải JSON), ví dụ
{MESSAGE}: {NAME} trên {SERVER} - Tiêu đề (Headers) (tùy chọn, mỗi dòng một mục):
Title: Agent DVR Tags: rotating_light Priority: high
Cài đặt ứng dụng ntfy trên điện thoại và đăng ký chủ đề của bạn để nhận cảnh báo.
Các dịch vụ khác
Bất cứ thứ gì chấp nhận HTTP POST đều hoạt động theo cùng một cách, ví dụ trình kích hoạt webhook của Home Assistant (http://homeassistant.local:8123/api/webhook/id-cua-ban - mặc dù tích hợp MQTT phong phú hơn). Agent DVR gửi nội dung JSON dưới dạng application/json và mọi thứ khác được mã hóa dạng form. Bạn có thể thêm các header bổ sung (ví dụ khóa API) trong trường Tiêu đề (Headers), mỗi dòng một mục theo dạng Name: Value.