您的產品可以使用Nest API來幫助防止家庭入侵。
當所有家庭成員都出門在外時,結構便進入了away
模式。當Nest Cam檢測到人時,Camera API的/last_event/has_person
字段將更改為true
。
這兩個狀態共同觸發了Nest Security API的使用,如下所示:
如果在結構處於away
模式時Nest Cam檢測到有人的存在,則結構將進入deter
模式。
當您的產品檢測到該結構處於deter
模式時,您的產品可以通過以某種方式改變家庭環境來使家庭“假裝”被佔用,例如打開燈,播放音樂或打開百葉窗來製造入侵者更明顯。
這樣,家庭成為攻擊的誘人目標。
要求
要使用安全性API,請執行以下操作:
- 您的客戶端必須具有以下權限:
- 安全狀態讀取/ v1
- 結構讀/寫/ v1
- 相機讀取/ v3
- 結構
away
狀態必須準確,這意味著:- 必須在Nest應用程序中將所有家庭居民添加為家庭成員。
- 所有家庭成員都必須在手機上安裝了Nest應用,並且啟用了家庭/外出協助。
- 該結構必須至少具有一個可發送人員警報的Nest Cam。對於某些Nest Cam型號,Nest Cam必須訂閱Nest Aware才能獲得人員警報。
詳細了解用戶從不同型號的相機獲得的警報。
安全功能
滿足以下條件時,安全狀態會逐步升級以deter
:
- 結構狀態
away
。 - 結構包含至少一個Nest Cam,該Nest Cam具有:
- 處於在線狀態並積極流式傳輸
- 觸發最後一個事件,其中
has_person = "true"
幾分鐘後,將重新評估deter
狀態,如果沒有其他has_person
事件發生,則放寬到ok
。
當結構狀態為Home
時,安全狀態會自動切換為ok
。
對deter
狀態做出反應的Works with Nest產品也應對該狀態的降級做出反應。例如,燈光和音樂,在一轉上模擬佔用deter
狀態,在後最終應關閉www_security_state
去升級到ok
。
安全權限
要使用安全性API,請選擇“安全性狀態讀取/ v1”權限。
安全API沒有可用的寫權限。
安全值
使用wwn_security_state
字段查看安全狀態。
值 | 描述 |
---|---|
ok | 正常運行,一切都很好 |
deter | 結構狀態away 檢測到的人 |