整合 - 整合

API (應用程式介面)

API 的範例和文件已經移至 https://ispysoftware.github.io/Agent_API/

指令

要在Agent DVR中訪問命令,請點擊Agent UI左上角的服務器圖標,然後在系統下選擇"命令"。快捷方式是按下"C"鍵。


Agent DVR包含多個預先建立的命令,可以同時控制多個設備。這些命令利用API執行各種任務。您可以靈活添加自己的自定義命令,以調用API或在計算機上運行軟件。

調用腳本文件

要執行通用腳本文件,只需將.bat文件(或Linux/OSX上的.sh文件)添加到命令目錄中。腳本的文件名(不包括擴展名)將顯示在命令列表中,可以點擊運行。注意:您可能需要重新加載UI才能顯示。

調用API

在Agent安裝的Commands文件夾中創建一個新的.bat文件。第一行應該是:
REM ispy-internal
這行表示該文件應由Agent內部處理,而不是作為獨立應用程序執行。

後續行將被解釋為Agent的API命令。例如:

REM ispy-internal
switchon&group=external
switchoff&group=internal
record&group=external
broadcast 'external cameras are on and recording'

這些命令附加到API調用的格式/command.cgi?cmd=...。因此,您可以使用API中可用的任何命令。

上述示例命令將激活所有標記為"external"的設備,停用所有"internal"設備,開始在"external"設備上錄製,並向所有連接的客戶端發送廣播消息。

請參閱readme命令按鈕上的示例以及API文檔中提供的可用命令列表。

請記住在命令中使用&而不是?來分隔參數。

重新加載UI並按下"C"鍵後,您的新命令應該在列表中可見。點擊它以執行。

從版本3.8.1.0+開始,您可以在命令中使用位置名稱(例如switchon&location=home)。只需首先為您的設備分配一個位置!

Amazon Alexa

從版本2.9.5.0開始,Agent DVR提供Amazon Alexa集成。此功能允許您通過Alexa兼容設備的語音命令來控制Agent DVR。您可以對系統進行布防或撤防,或在Alexa Show設備上顯示實時視頻鏈接。

要設置它,請在Agent DVR的Server菜單中的Integrations下選擇“Alexa”。這將將您重定向到Amazon以連接您的帳戶。

連接後,運行Alexa的發現過程。它應該會找到兩個設備:安全面板和攝像頭控制。

現在,您可以使用以下語音命令:

  • "Alexa,布防Agent進入家庭模式"
  • "Alexa,顯示Agent攝像頭"

在Agent設置中設置您的安全代碼以進行需要驗證的操作。默認代碼為1234。

Alexa配置文件(家庭/離開/夜間)與Agent DVR中的配置文件相匹配。請在Server - Profiles中進行配置。

對於多個服務器,請在設置中設置服務器名稱並在語音命令中使用它。

家庭助手

Agent DVR 完全整合了 Home Assistant,允許您將 Agent DVR 添加到您的 Home Assistant 設置中。將 Agent DVR 面板嵌入 lovelace UI 或選擇個別攝像頭。它還包括主要安全面板的控制功能。有關更多信息,請參閱 Server - Integrations 下的 Home Assistant 鏈接。

IFTTT(If This Then That)

IFTTT 讓您可以設定與物聯網設備的動作和觸發器。首先,將您的 IFTTT 帳戶與 iSpyConnect.com 進行連結,可在伺服器 - 整合中找到。

推送警報

設置行動推送警示詳情請參閱設置推送警示

Telegram [電報]

Telegram Bot Example

將Agent DVR與Telegram聊天機器人連接,以進行控制和即時警報通知。在設備設置中啟用推送通知以獲取即時警報。首先,在遠程網頁界面的服務器圖標下選擇Telegram按鈕。

Python包裝器

這裡有一個用於基本 UI 功能的 Python 封裝程式:agent-py

URL參數

您可以通過調用Agent DVR的URL以打開特定視圖(區分大小寫):

  • ?start=Live&viewIndex=3(在第3個視圖上進行實時視圖)
  • ?start=TimeMachine(時光機視圖)
  • ?start=TimeLine(時間軸視圖)
  • ?start=Photos(照片視圖)
  • ?start=Recordings(錄像視圖)
  • ?start=Floorplans&planIndex=2(在第2個平面圖上的平面圖視圖)
  • ?start=VR(虛擬現實)

您可以使用特定語言打開Agent DVR(繞過語言選擇)。只需傳入2個字母的語言代碼:?lang=fr

您可以通過使用過濾器參數傳入已保存的過濾器名稱來應用過濾器,例如:?start=Recordings&filter=intruder。您還可以使用JavaScript ticks傳入過濾器的起始時間和結束時間,例如:?start=timeline&from=1657841514949&to=1657852514949。

設置默認主題選項(主題選項在賬戶菜單中可用-主題設置):

  • ?theme=darkly&variant=dark&large=false
  • ?theme=sketchy&variant=primary&large=true

自動播放音頻(可能還需要更改瀏覽器設置):

  • ?playaudio=true

以最小化模式啟動(隱藏頂部和底部的UI條):

  • ?mini=true

傳入本地用戶名和密碼以進行自動登錄(請注意-這將將您的憑據暴露給網絡):

  • ?un=username&pwd=password
文件
應用篩選器