Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
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 .