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.
Эта страница была переведа с помощью Cloud Translation API.
Switch to English

Smoke + CO Alarm

Дым + СО сигнализация

Nest Protect предназначен для обнаружения дыма и угарного газа (CO) в жилых помещениях с несколькими датчиками, помогающими понять, что происходит в доме.

API Nest предоставляет доступ к следующим данным в Nest Protect:

  • Состояние тревоги дыма или угарного газа (CO)
  • Состояние батареи
  • Последнее ручное состояние теста и отметка времени
  • Онлайн статус и информация о последнем подключении
  • Структура имени и устройства «где имя» (местоположение в доме)

Дым + CO разрешения

Для доступа на чтение ко всем значениям API-сигналов тревоги Smoke + CO выберите разрешение на чтение Smoke + CO для своего клиента.

Для API сигнализации Smoke + CO нет разрешений на запись.

Smoke + CO идентификаторы

устройство

Гнезда устройства перечислены по типу в виде массива идентификаторов, которые могут быть использованы для однозначной идентификации устройства через путь устройства. Таким образом, идентификатор "RTMTKxs..." дым + со-тревога "RTMTKxs..." означает, что вы можете загрузить модель devices/smoke_co_alarms/RTMTKxs... «дым + со-тревога» в devices/smoke_co_alarms/RTMTKxs... через API.

Когда устройство подключено к нескольким продуктам, каждый разработчик увидит свой идентификатор для этого устройства. Для устройства, на котором установлено несколько продуктов от одного разработчика, разработчик увидит один и тот же идентификатор.

название

Предоставляются два атрибута имени. Более короткий атрибут name отображается в метках пользовательского интерфейса, а name_long используется в длинном тексте формы.

name

В этом примере name «Nest Protect».

название

name_long

В этом примере name_long - «Защита подвального гнезда».

Имя длинное

куда

where_id

  • Уникальный сгенерированный гнездом идентификатор, представляющий name
  • where_id только для чтения и создается автоматически при вызове для создания пользовательского name где

Узнайте больше о названиях термостатов Nest , Nest Protects и Nest Cams .

where_name

where_name разрешение на чтение Smoke + CO , вы можете получить доступ к устройству where_name из объекта devices/smoke_co_alarms ( devices/smoke_co_alarms ).

Другие метаданные

Все значения данных доступны только для чтения, если не указано иное.

Значение данных Описание
locale Язык и код страны, присвоенные этому устройству
software_version Строка, представляющая прошивку, установленную в данный момент на устройстве.
structure_id Строка, которая уникально представляет эту структуру; это структура, с которой устройство сопряжено
last_connection Отметка времени последнего успешного подключения к службе Nest
is_online Онлайн статус. Это определяется Nest с использованием времени last_connection и ожидаемого окна переподключения, которое зависит от устройства.

Особенности Smoke + CO

Здоровье батареи

Используйте поле battery_health для просмотра состояния батареи.

Стоимость Описание
ok Уровень заряда батареи в порядке
replace Низкий уровень заряда батареи, должен быть заменен

Сигнализация СО

Используйте поле co_alarm_state для просмотра состояния тревоги CO.

Стоимость Описание
ok Нормальная операция
warning Обнаружение повышения уровня СО
emergency Уровень CO слишком высок, пользователь должен выйти из дома

Дымовая сигнализация

Используйте поле smoke_alarm_state для просмотра состояния дымовой сигнализации.

Стоимость Описание
ok Нормальная операция
warning Обнаружение повышения уровня дыма
emergency Уровень дыма слишком высокий, пользователь должен выйти из дома

Ручной тест

Используйте эти поля, чтобы проверить, активен ли в данный момент ручной тест на дым или CO, и в последний раз был успешно выполнен тест на дым или CO.

Цветовой интерфейс

Чтобы упростить разработку связного пользовательского интерфейса для нескольких продуктов, мы предоставили поле ui_color_state , которое дает общее представление об общем состоянии Nest Protect. Он получен из is_online , battery_health , co_alarm_state и smoke_alarm_state , предоставляя совокупное условие, отражающее фактические цветовые индикаторы, отображаемые в приложении Nest .

Сообщения об ошибках

Для получения информации о том, что означают ошибки вызова API и как их обрабатывать, см. Сообщения об ошибках .