用於從 Home Assistant 切換 QVR Pro 動作規則的 API

我正在尋找一種乾淨且有文件的方法,讓 QVR Pro 僅在我離開家時開始錄影,並在我回家時停止錄影。
到目前為止,我已經閱讀了很多資料,也嘗試了一些變通方法,但我很想知道其他用戶是如何解決(或會如何解決)這種情境,最好是使用官方支援的 API/功能。

我的設定

元件 細節
NAS QNAP TS‑253D
QVR Pro 2.7.1.1259
攝影機 6 台 ONVIF 攝影機,各自有一個「移動偵測」規則
Home Assistant Core 2025.7(在 Docker/Container Station 中)
在家狀態追蹤 Companion App(同伴應用程式)在 Android 上(會將 device_tracker.my_phone 狀態切換為 homenot_home

我想要達成的目標

  1. 當我的手機斷開家中 Wi‑Fi 連線時
    → QVR Pro 應該啟用客廳攝影機的移動偵測規則。
  2. 當手機重新連線時
    → QVR Pro 應該停用該規則(我在家時保有隱私)。

所以,基本上我需要一個 API 呼叫或 webhook 來切換規則的「啟用/停用」開關。


我嘗試過的方法

  • Event URL(事件網址)
    建立了兩個自訂事件(ExitHomeEnterHome),並透過 Home Assistant 觸發
    .../qvrpro/event/exec?event_id=ExitHome&event_status=on
    可行 ↔ QVR Pro 能收到事件,但我還需要一個動作啟用/停用規則。在 2.7.1 版本中,我找不到「啟用事件規則」這個選項了。
  • rule_operation.cgiRuleActive
    透過 DevTools 發現 GUI 會呼叫
    POST /qvrpro/rule_operation.cgi RuleGUID=...&enable=1|0
    這在瀏覽器中可行,但需要 session 的 QVR‑Token,而且使用者登出後 token 會失效——對自動化來說不理想。
  • /api/v1/eventRules/{id}
    Open Event Platform 文件有提到 PUT ...eventRules/{id} {"enabled":true/false},但在我的 2.7.1 版本呼叫會回傳 404(可能已經棄用?)。

我的問題

  1. 2.7.1 版是否有官方(token 驗證、免密碼)的 API 端點可以啟用/停用規則?
  2. 有的話能否提供範例 curl 或 Postman 指令片段?
  3. 如果沒有:2025 年推薦的做法是什麼?
  4. 你們還有用 Event URL +「啟用事件規則」這個動作嗎(這選項現在藏在哪)?
  5. 還是你們都用 /cfg/rule_operation.cgi 並讓服務帳號長期登入?
  6. 有沒有什麼最佳實踐,能讓 QVR Pro 與 Home Assistant 在家狀態偵測結合?(如果方案穩定,我很樂意寫成 wiki 文件分享。)

先謝謝大家的任何提示、腳本或最新文件連結!

跨平台發文至 reddit
https://www.reddit.com/r/qnap/comments/1m1sbde/toggle_onoff_qvr_pro_motion_rules_from_home/

請告訴你的 AI 文字機下次把這些問題縮短一點,我們不想讀一大篇文章

讓 QVR Pro 只在我離開家時開始錄影,回家時再停止。

我已經向團隊確認過,很抱歉,目前 QVR Server(包括 Pro 和 Elite 2.7)都不支援這類設定。

我們確實正在探索類似的功能——利用手機上的 QVR Client Mobile app 來偵測位置,這樣就能在離開家時通知 QVR Server 開始錄影,回家時則停止。

如果這項功能有任何更新,我一定會第一時間分享,謝謝。