Tích hợp

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 .

Có một bọc python cho chức năng giao diện người dùng cơ bản ở đây: agent-py .

Bạn có thể mở Agent DVR tới một view 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 (live view trên view 3)
• ?start=Live&viewIndex=3&ot=2&oid=2&max=true (live view trên view 3, camera id 2 được phóng to). "oid" là object id của thiết bị (hiển thị ở đầu hộp thoại khi bạn chỉnh sửa camera), "ot" là loại object - 1 = microphone, 2 = camera.
• ?start=TimeMachine (timemachine view)
• ?start=Timeline (timeline view)
• ?start=Photos (photos view)
• ?start=Recordings (recordings view)
• ?start=Floorplans&planIndex=2 (floorplans view trên plan 2)
• ?start=VR (virtual reality)

Bạn có thể mở Agent DVR với một ngôn ngữ cụ thể (bỏ qua lựa chọn ngôn ngữ). Chỉ cần truyền mã ngôn ngữ 2 chữ cái: ?lang=fr

Bạn có thể truyền tên của một bộ lọc đã lưu để áp dụng bằng tham số filter - ví dụ: ?start=Recordings&filter=intruder. Bạn cũng có thể truyền thời gian từ và đến cho bộ lọc bằng javascript ticks. ví dụ ?start=timeline&from=1657841514949&to=1657852514949.

Đặt tùy chọn chủ đề mặc định (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ũng 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 tên người dùng và mật khẩu cục bộ để tự động đăng nhập (cảnh báo - điều này sẽ phơi bày thông tin xác thực của bạn cho mạng):

• ?un=username&pwd=password

Mở một cảnh báo cụ thể theo alert id (trong alert json):

• ?alertid=xxx

Để truy cập Commands trong Agent DVR, nhấp vào biểu tượng Server ở góc trên cùng bên phải của giao diện Agent DVR, rồi chọn "Commands" dưới System. Phím tắt nhanh là nhấn "Alt-C".

Agent DVR bao gồm nhiều lệnh được tạo sẵn có thể điều khiển nhiều thiết bị cùng một lúc. Những lệnh này sử dụng API để thực hiện các tác vụ khác nhau. Bạn có thể 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 Tệp Kịch Bản

Để thực thi một tệp kịch bản chung, chỉ cần thêm tệp .bat (hoặc tệp .sh trên Linux/macOS) vào thư mục commands. Tên tệp của kịch bản (không có phần mở rộng) sẽ xuất hiện trong danh sách Commands và có thể nhấp để chạy. Lưu ý: Bạn có thể cần tải lại giao diện để nó xuất hiện.

Gọi API

Tạo tệp .bat mới trong thư mục Commands nơi Agent DVR được cài đặt. Dòng đầu tiên phải là:

REM ispy-internal

Các dòng tiếp theo được diễn giải như các lệnh cho API của Agent DVR. Ví dụ:

 REM ispy-internal

 switchon&group=external

 switchoff&group=internal

 record&group=external

 broadcast 'external cameras are on and recording'

Những lệnh này được nối vào các lệnh gọi API dưới đị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ả các thiết bị được gán nhãn "external", vô hiệu hóa tất cả các thiết bị "internal", bắt đầu ghi hình trên các thiết bị "external", và gửi thông báo quảng bá cho tất cả các máy khách được kết nối.

Tham khảo nút lệnh readme để xem các 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 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 nó để 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!

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.

Agent DVR tích hợp hoàn toàn với Home Assistant, cho phép bạn thêm Agent DVR vào thiết lập Home Assistant của mình. Nhúng bảng điều khiển Agent DVR trong giao diện lovelace hoặc chọn các camera riêng lẻ. Nó cũng bao gồm một điều khiển cho bảng điều khiển bảo mật chính. Để biết thêm thông tin, hãy xem liên kết Home Assistant trong phần Server - Integrations.

Agent DVR cũng có thể xuất bản các thiết bị của nó đến Home Assistant dưới dạng cảm biến và công tắc thông qua MQTT: xem Khám phá Home Assistant MQTT.

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.

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.

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.

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.