Hướng dẫn người dùng: Tích hợp Tích hợp

API

Các ví dụ và tài liệu API đã được chuyển đến https://ispysoftware.github.io/Agent_API/

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 "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/OSX) 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.

Nhớ sử dụng & thay vì ? để phân tách các tham số trong các lệnh của bạn.

Sau khi tải lại Giao diện người dùng và nhấn "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

Ví dụ Telegram Bot

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 Hướng dẫn người dùng
Bộ lọc đã được áp dụng