O Google está comprometido em promover a equidade racial para as comunidades negras. Veja como.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

Alarme de fumaça + CO

Alarme de fumaça + CO

O Nest Protect foi projetado para detectar fumaça e monóxido de carbono (CO) em um ambiente residencial, com vários sensores para ajudá-lo a entender o que está acontecendo em casa.

A API do Nest fornece acesso aos seguintes dados no Nest Protect:

  • Status de alarme de fumaça ou monóxido de carbono (CO)
  • Estado de funcionamento da bateria
  • Último status do teste manual e carimbo de data e hora
  • Informações on-line e última conexão
  • Nome da estrutura e dispositivo "where name" (localização na casa)

Permissões de fumaça + CO

Para acesso de leitura a todos os valores de dados da API de alarme do Smoke + CO, selecione a permissão de leitura do Smoke + CO para o seu cliente.

Não há permissões de gravação disponíveis para a API de alarme Smoke + CO.

Identificadores de fumaça + CO

Dispositivo

Os dispositivos aninhados são listados por tipo como uma matriz de IDs, que podem ser usados ​​para identificar exclusivamente um dispositivo pelo caminho do dispositivo. Portanto, um ID de alarme de fumaça + co de "RTMTKxs..." significa que você pode carregar o modelo de dispositivo de alarme de fumaça + co em devices/smoke_co_alarms/RTMTKxs... por meio da API.

Quando um dispositivo está conectado a vários produtos, cada desenvolvedor verá um ID diferente para esse dispositivo. Para um dispositivo que instalou vários produtos do mesmo desenvolvedor, o desenvolvedor verá o mesmo ID.

Nome

Dois atributos de nome são fornecidos. O atributo de name mais curto é exibido nos rótulos da interface do usuário, enquanto name_long é usado no texto longo.

name

Neste exemplo, o name é "Nest Protect".

Nome

name_long

Neste exemplo, name_long é "Basement Nest Protect".

Nome longo

Onde

where_id

  • Um identificador exclusivo gerado pelo Nest que representa o name
  • where_id é somente leitura e é criado automaticamente na chamada para criar um name where personalizado

Saiba mais sobre os nomes dos termostatos , Nest Protects e Nest Cams da Nest .

where_name

Ao escolher a permissão de leitura Smoke + CO , você pode acessar o dispositivo where_name no objeto device ( devices/smoke_co_alarms ).

Outros metadados

Todos os valores de dados são somente leitura, a menos que especificado de outra forma.

Valor dos dados Descrição
locale O idioma e o código do país atribuído a este dispositivo
software_version Uma sequência que representa o firmware atualmente instalado no dispositivo
structure_id Uma sequência que representa exclusivamente essa estrutura; essa é a estrutura com a qual o dispositivo está emparelhado
last_connection O registro de data e hora da última conexão bem-sucedida ao serviço Nest
is_online Status online. Isso é determinado pelo Nest usando o tempo da last_connection e uma janela de reconexão esperada específica do dispositivo.

Recursos Smoke + CO

Funcionamento da bateria

Use o campo battery_health para visualizar o estado de funcionamento da bateria.

Valor Descrição
ok Nível da bateria ok
replace Bateria com pouca carga, deve ser substituída

Alarme de CO

Use o campo co_alarm_state para visualizar o estado do alarme de CO.

Valor Descrição
ok Operação normal
warning Detecção de níveis crescentes de CO
emergency Níveis de CO muito altos, o usuário deve sair de casa

Alarme de fumo

Use o campo smoke_alarm_state para visualizar o estado do alarme de fumaça.

Valor Descrição
ok Operação normal
warning Detecção de níveis crescentes de fumaça
emergency Níveis de fumaça muito altos, o usuário deve sair de casa

Teste manual

Use esses campos para verificar se um teste manual de fumaça ou CO está ativo no momento e a última vez que um teste bem-sucedido de fumaça ou CO foi realizado.

Estado da cor da interface do usuário

Para facilitar o design de uma interface do usuário coerente entre produtos, fornecemos o campo ui_color_state , que fornece uma indicação de alto nível do estado geral do Nest Protect. É derivado de is_online , battery_health , co_alarm_state e smoke_alarm_state , fornecendo uma condição agregada que reflete os indicadores de cores reais exibidos no aplicativo Nest .

Mensagens de erro

Para obter informações sobre o significado dos erros de chamada da API e como lidar com eles, consulte Mensagens de erro .