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

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

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

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

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

  • Состояние тревоги по дыму или угарному газу (CO)
  • Состояние здоровья батареи
  • Состояние и отметка времени последнего ручного теста
  • Информация о онлайн-статусе и последнем подключении
  • Название структуры и устройство "где имя" (местонахождение в доме)

Разрешения Smoke + CO

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

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

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

Устройство

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

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

Имя

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

name

В этом примере name является «Гнездо Protect».

Имя

name_long

В этом примере, name_long является «Подвал Nest Protect».

Имя длинное

Где

where_id

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

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

where_name

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

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

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

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

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

Состояние батареи

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

Значение Описание
ok Уровень заряда батареи в норме
replace Низкий уровень заряда батареи, необходимо заменить

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

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

Значение Описание
ok Нормальная операция
warning Обнаружение повышения уровня CO
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 вызова и как обращаться с ними, увидеть сообщения об ошибках .