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

Alarm dymu + CO

Alarm dymu + CO

Nest Protect przeznaczony jest do wykrywania dymu i tlenku węgla (CO) w środowisku mieszkalnym, z wielu czujników, aby pomóc im zrozumieć, co się dzieje w domu.

Nest API umożliwia dostęp do następujących danych na gniazdo Protect:

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

Uprawnienia do palenia+CO

Dla dostępu do odczytu wszystkich wartości + CO alarm dymu danych API, wybierz Smoke + CO przeczytać zgodę na kliencie.

Brak uprawnień do zapisu dla interfejsu API alarmów Smoke+CO.

Dym+CO identyfikatory

Urządzenie

Urządzenia zagnieżdżone są wymienione według typu jako tablica identyfikatorów, których można użyć do jednoznacznej identyfikacji urządzenia na ścieżce urządzenia. Więc dymu + CO alarmowego ID "RTMTKxs..." oznacza, że można załadować + CO model urządzenia alarm przeciwpożarowy w devices/smoke_co_alarms/RTMTKxs... za pośrednictwem interfejsu API.

Gdy urządzenie jest połączone z wieloma produktami, 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.

Nazwa

Dostępne są dwa atrybuty nazwy. Im krótsza name atrybutu jest wyświetlane w etykietach interfejs użytkownika, podczas name_long jest stosowany w dłuższej formie tekstowej.

name

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

Nazwa

name_long

W tym przykładzie, name_long jest „Piwnica Nest Protect”.

Imię długie

Gdzie

where_id

  • Wyjątkowy, Gniazdo wygenerowany identyfikator, który reprezentuje name
  • where_id , jest tylko do odczytu i jest tworzony automatycznie w zaproszeniu do tworzenia niestandardowych ustawień, gdzie name

Dowiedz się więcej o tym, gdzie nazwy Termostaty Nest ,Gniazdo Chroni i Nest kamery internetowe .

where_name

Po wybraniu Smoke + CO uprawnienia do odczytu , można uzyskać dostęp do urządzenia where_name od 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 Kod języka i kraju przypisany do tego urządzenia
software_version Ciąg reprezentujący oprogramowanie układowe aktualnie zainstalowane na urządzeniu
structure_id Ciąg, który jednoznacznie reprezentuje tę strukturę; jest to struktura, z którą urządzenie jest sparowane
last_connection Znacznik czasu ostatniego udanego połączenia z usługą Nest
is_online Status aktywności. To zależy od gniazdem używając last_connection czas i oczekiwanego okna ponownego zwarcia, który jest specyficzny dla urządzenia.

Funkcje dymu + CO

Stan baterii

Użyj battery_health boiska w celu sprawdzenia stanu zdrowia baterii.

Wartość Opis
ok Poziom naładowania baterii ok
replace Niski poziom naładowania baterii, należy go wymienić

Alarm CO

Użyj co_alarm_state pole, aby zobaczyć stan alarmowy CO.

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

Alarm przeciwpożarowy

Użyj smoke_alarm_state pole, aby zobaczyć stan alarmowy dym.

Wartość Opis
ok Normalna operacja
warning Wykrywanie rosnącego poziomu dymu
emergency Za wysoki poziom dymu, użytkownik powinien wyjść z domu

Test ręczny

Użyj tych pól, aby sprawdzić, czy ręczny test zadymienia lub tlenku węgla jest aktualnie aktywny, a także ostatni raz, kiedy przeprowadzono pomyślny test zadymienia lub tlenku węgla.

Stan koloru interfejsu użytkownika

Aby ułatwić zaprojektowanie spójnego interfejsu przekrój produktów, jakie dostarczyła ui_color_state boiska, co daje wskazanie wysokiego poziomu ogólnego stanu gniazdem chronić. Wywodzi się z is_online , battery_health , co_alarm_state i smoke_alarm_state , zapewniając warunek łączny odzwierciedlającej rzeczywiste wskaźniki kolorów wyświetlanych w aplikacji Nest .

Komunikaty o błędach

Aby uzyskać informacje o tym, co znaczy błędy wywołania API i jak sobie z nimi radzić, patrz Komunikaty o błędach .