Google jest zaangażowany w promowanie równości rasowej dla społeczności czarnych. Zobacz jak.
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

Alarm dymu i tlenku węgla

Alarm dymu i tlenku węgla

Nest Protect został zaprojektowany do wykrywania dymu i tlenku węgla (CO) w środowisku mieszkalnym, z wieloma czujnikami, które pomagają zrozumieć, co dzieje się w domu.

Nest API zapewnia dostęp do następujących danych w Nest Protect:

  • Stan alarmu dymu lub tlenku węgla (CO)
  • Stan baterii
  • Stan ostatniego testu ręcznego i sygnatura czasowa
  • Stan online i informacje o ostatnim połączeniu
  • Nazwa struktury i „gdzie nazwa” urządzenia (lokalizacja w domu)

Uprawnienia do palenia i emisji CO

Aby uzyskać dostęp do odczytu wszystkich wartości danych API alarmu Smoke + CO, wybierz uprawnienie odczytu Smoke + CO dla swojego klienta.

Brak dostępnych uprawnień do zapisu dla interfejsu API alarmu dymu i CO.

Identyfikatory dymu + CO

Urządzenie

Urządzenia Nest są wymienione według typu jako tablica identyfikatorów, których można użyć do jednoznacznej identyfikacji urządzenia za pomocą ścieżki urządzenia. Tak więc identyfikator alarmu dymu + co "RTMTKxs..." oznacza, że ​​można załadować model urządzenia alarmu dymu + co w devices/smoke_co_alarms/RTMTKxs... przez API.

Gdy urządzenie jest podłączone do wielu produktów, każdy programista zobaczy inny identyfikator tego urządzenia. W przypadku urządzenia, na którym zainstalowano wiele produktów tego samego programisty, programista zobaczy ten sam identyfikator.

Imię

Podano dwa atrybuty nazwy. Krótszy atrybut name jest wyświetlany w etykietach interfejsu użytkownika, natomiast name_long jest używany w długim tekście.

name

W tym przykładzie name to „Nest Protect”.

Imię

name_long

W tym przykładzie name_long to „Ochrona gniazda piwnicy”.

Imię długie

Gdzie

where_id

  • Unikalny, wygenerowany przez Nest identyfikator, który reprezentuje name
  • where_id jest tylko do odczytu i jest tworzony automatycznie w wywołaniu w celu utworzenia niestandardowej name gdzie

Dowiedz się więcej o nazwach termostatów Nest, zabezpieczeń Nest i kamer Nest .

where_name

Gdy wybierzesz uprawnienie do odczytu Smoke + CO , możesz uzyskać dostęp do urządzenia where_name z obiektu urządzenia ( devices/smoke_co_alarms ).

Inne metadane

Wszystkie wartości danych są tylko do odczytu, chyba że określono inaczej.

Wartość danych Opis
locale Język i kod kraju przypisany do tego urządzenia
software_version Ciąg, który reprezentuje oprogramowanie układowe aktualnie zainstalowane na urządzeniu
structure_id Ciąg, który w unikalny sposób reprezentuje tę strukturę; to jest struktura, z którą sparowane jest urządzenie
last_connection Sygnatura czasowa ostatniego udanego połączenia z usługą Nest
is_online Status aktywności. Jest to określane przez Nest przy użyciu czasu last_connection i oczekiwanego okna ponownego połączenia, które jest specyficzne dla urządzenia.

Funkcje Smoke + CO

Stan baterii

Użyj pola battery_health aby wyświetlić stan baterii.

Wartość Opis
ok Poziom baterii w porządku
replace Niski poziom baterii, należy wymienić

Alarm CO

Użyj pola co_alarm_state aby wyświetlić stan alarmu CO.

Wartość Opis
ok Normalna operacja
warning Wykrywanie rosnących poziomów CO
emergency Zbyt wysoki poziom CO, użytkownik powinien wyjść z domu

Alarm przeciwpożarowy

Użyj pola smoke_alarm_state aby wyświetlić stan alarmu dymu.

Wartość Opis
ok Normalna operacja
warning Wykrywanie rosnących poziomów dymu
emergency Zbyt wysoki poziom dymu, użytkownik powinien wyjść z domu

Test ręczny

Użyj tych pól, aby sprawdzić, czy ręczny test dymu lub CO jest aktualnie aktywny i czy ostatnio był przeprowadzony pomyślnie test dymu lub CO.

Stan koloru interfejsu użytkownika

Aby ułatwić projektowanie spójnego interfejsu użytkownika dla różnych produktów, udostępniliśmy pole ui_color_state , które zawiera ogólne wskazanie ogólnego stanu Nest Protect. Pochodzi z is_online , battery_health , co_alarm_state i smoke_alarm_state , zapewniając łączny stan, który odzwierciedla rzeczywiste wskaźniki kolorów wyświetlane w aplikacji Nest .

Komunikaty o błędach

Aby uzyskać informacje o tym, co oznaczają błędy wywołań interfejsu API i jak sobie z nimi radzić, zobacz Komunikaty o błędach .