您的產品可以使用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檢測到的人 |