Google is committed to advancing racial equity for Black communities. See how.

煙霧+一氧化碳警報

煙霧 + CO 警報

巢保護設計用於檢測煙霧和一氧化碳(CO)在居住環境,與多個傳感器,以幫助其了解情況,在家裡。

巢API可以訪問以下數據上巢保護:

  • 煙霧或一氧化碳 (CO) 警報狀態
  • 電池健康狀態
  • 上次手動測試狀態和時間戳
  • 在線狀態和上次連接信息
  • 結構名稱和設備“where name”(在家中的位置)

Smoke+CO 權限

對於讀訪問所有的煙霧和一氧化碳報警器API的數據值,選擇煙霧和一氧化碳讀取權限為您的客戶。

Smoke+CO 警報 API 沒有可用的寫入權限。

煙霧+一氧化碳標識符

設備

Nest 設備按類型作為 ID 數組列出,可用於通過設備路徑唯一標識設備。所以的煙霧和一氧化碳報警器ID "RTMTKxs..."意味著你可以加載在煙霧和一氧化碳報警裝置型號devices/smoke_co_alarms/RTMTKxs...通過API。

當一個設備連接到多個產品時,每個開發人員都會看到該設備的不同 ID。對於安裝了來自同一開發者的多個產品的設備,開發者將看到相同的 ID。

名稱

提供了兩個名稱屬性。較短的name屬性被顯示在用戶界面的標籤,而name_long在長格式文本中使用。

name

在這個例子中, name是“鳥巢保護”。

名稱

name_long

在這個例子中, name_long是“地下室巢保護”。

名字長

在哪裡

where_id

  • 代表一個唯一的,巢生成的標識符name
  • where_id是只讀的,並在通話中自動創建創建自定義的地方name

了解更多關於哪裡的名字鳥巢恆溫器巢保護巢凸輪

where_name

當選擇煙霧+ CO讀取權限,則可以訪問設備where_name從設備對象( devices/smoke_co_alarms )。

其他元數據

除非另有說明,否則所有數據值都是只讀的。

數據值描述
locale分配給此設備的語言和國家/地區代碼
software_version表示設備上當前安裝的固件的字符串
structure_id唯一表示此結構的字符串;這是設備配對的結構
last_connection上次成功連接到 Nest 服務的時間戳
is_online在線狀態。這是通過使用Nest確定last_connection時間,這是設備特定的預期的重新連接的窗口。

煙霧+一氧化碳特性

電池健康

使用battery_health現場查看電池健康狀態。

價值描述
ok電池電量正常
replace電池電量低,應更換

一氧化碳報警器

使用co_alarm_state現場查看CO報警狀態。

價值描述
ok普通手術
warning檢測不斷上升的 CO 水平
emergency CO 水平太高,用戶應該離開家

煙霧報警器

使用smoke_alarm_state現場查看煙霧報警狀態。

價值描述
ok普通手術
warning檢測上升的煙霧水平
emergency煙霧濃度太高,用戶應該離開家

手動測試

使用這些字段檢查手動煙霧或 CO 測試當前是否處於活動狀態,以及上次成功執行煙霧或 CO 測試的時間。

界面顏色狀態

為了更容易地設計一個連貫的跨產品的UI,我們提供的ui_color_state場,這給鳥巢保護的整體狀態的一個高層次的指示。衍生它的is_onlinebattery_healthco_alarm_state ,和smoke_alarm_state ,提供反映在所顯示的實際顏色指標聚集條件Nest應用

錯誤信息

對於哪些API調用錯誤的含義及如何處理這些信息,請參閱錯誤信息