Segurança

Seu produto pode usar a API Nest para ajudar a prevenir invasões domiciliares.

Quando todos os membros da família estão longe de casa, a estrutura entra away modo. Quando um Cam Nest detecta uma pessoa, a Câmara de API /last_event/has_person campo muda a true .

Esses dois estados trabalham juntos para acionar a API Works with Nest Security, da seguinte maneira:

Se uma CAM de ninho detecta a presença de uma pessoa, enquanto a estrutura está na away modo, a estrutura entra deter modo.

Quando detecta o produto que a estrutura está em deter modo, o seu produto pode tornar a casa "fingir" a ser ocupado pela alteração do ambiente familiar, de alguma forma, como acender as luzes, tocar música, ou abertura cortinas para fazer um intruso mais visível.

Dessa forma, a casa se torna um alvo menos convidativo para o ataque.

Requisitos

Para usar a API de segurança:

  • Seu cliente deve ter estas permissões:
    Ativar assistência em casa / fora de casa
    • Leitura do estado de segurança / v1
    • Estrutura de leitura / gravação / v1
    • Leitura da câmera / v3
  • A estrutura away estado devem ser precisas, o que significa:
    • Todos os ocupantes casa deve ser adicionado como membros da família no app Nest .
    • Todos os membros da família devem ter o app Nest instalado em seus telefones com o Assistente dentro / fora de casa ativado.
  • A estrutura deve ter pelo menos um Cam Nest capaz de enviar pessoa alertas. Para alguns modelos Nest Cam, o Cam Nest deve ter um Ciente Nest subscrição para obter pessoa alertas.

Saiba mais sobre os alertas de usuários começa a partir de diferentes modelos de câmera .

Recursos de segurança

O estado de segurança aumenta a deter quando os seguintes critérios são atendidos:

  • Estado estrutura é away .
  • A estrutura contém pelo menos uma Nest Cam que:
    • está online e transmitindo ativamente
    • desencadeia um último evento onde has_person = "true"

A deter estado é depois de vários minutos e relaxou a reavaliados ok , se não mais has_person eventos ocorreram.

O estado de segurança muda automaticamente para ok quando o estado estrutura é Home .

A Trabalha com produtos Nest que reage a uma deter estado também deve reagir à de-escalada desse estado. Por exemplo, luzes e música que gira sobre a ocupação simular num deter estado, deve, eventualmente, desligar após o www_security_state de-agrava a ok .

Permissões de segurança

Para usar a API de segurança, escolha a permissão Leitura / v1 do estado de segurança.

Não há permissões de gravação disponíveis para a API de segurança.

Valores de segurança

Use o wwn_security_state campo para ver o estado de segurança.

Valor Descrição
ok Operação normal, tudo está bem na estrutura
deter Pessoa detectada enquanto o estado estrutura é away