O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Câmera

Nest Cam

Nest Cam ™ é um dispositivo Internet-conectado que é intuitivo e fácil de usar. Ele aprende continuamente sobre os padrões de uso em casa para economizar energia e otimizar a segurança e o conforto. Os usuários podem controlar a Nest Cam de qualquer lugar com acesso à Internet.

A API Nest fornece acesso aos seguintes dados sobre Cam Nest, dependente do nível de permissões concedidas:

  • Nome da estrutura e dispositivo "onde nome" (localização na casa)
  • Status online da câmera ou status do microfone
  • Status do streaming (ligar / desligar o streaming de vídeo)
  • Nome do dispositivo e onde identificador
  • Última alteração de status online (última alteração online / offline)
  • Ciente ninho status da assinatura (matriculados / não inscrito)
  • Ligações profundas para a alimentação de câmera ao vivo no aplicativo Nest (iOS, Android) ou na web em home.nest.com
  • Conteúdo relacionado ao último evento que acionou uma notificação, incluindo:
    • Evento de som ou movimento detectado
    • Horários de início / parada do evento
    • Links profundos para arquivos de imagem e gif
  • Instantâneos de imagem sob demanda
  • Compartilhando status e público URL share
  • Zona de actividade nomes, e quando há um evento de movimento, os ids onde o movimento ocorrido (Requer Nest Aware )

Tipos de câmera

A API Nest oferece suporte a vários tipos de câmera:

  • Nest Cam Indoor - a câmera Nest interna original
  • Nest Cam Outdoor - a câmera Nest original para exterior
  • Nest Cam IQ interna - câmera Nest interna com capacidade de processamento adicional, permitindo reconhecimento sofisticado, alto-falante e recursos de instantâneo
  • Nest Cam IQ externa - câmera Nest externa com capacidade de processamento adicional, permitindo reconhecimento sofisticado, alto-falante e recursos de instantâneo
  • Nest Hello - uma câmera que funciona como uma campainha de vídeo

Observe que todas as câmeras Nest aparecem na API da mesma maneira. No caso do Nest Hello, apenas a parte da câmera do dispositivo aparece na API Nest. A funcionalidade de campainha além da câmera não está disponível na API.

Permissões de câmera

Os seguintes níveis de permissão de acesso estão disponíveis para a Nest Cam:



Acesso
Permissões
Câmera lida

Leitura / gravação da câmera

Leitura da câmera + imagens

Leitura / gravação da câmera + imagens
Pode ler todos os valores, excluindo:
activity_zones
is_public_share_enabled
public_share_url
snapshot_url
last_event/image_url
last_event/animated_image_url
last_event/activity_zone_ids
sim sim
Pode ler todos os valores sim sim
Pode escrever is_streaming (câmera on / off)
• Esta mudança de estado requer o acordo explícito do usuário
sim sim

Para mais informações, consulte o Visão geral das permissões .

Identificadores de câmera

Dispositivo

Os dispositivos Nest são listados por tipo como uma série de IDs, que podem ser usados ​​para identificar exclusivamente um dispositivo por meio do caminho do dispositivo. Assim, um ID de câmera de "awJo6rH..." significa que você pode carregar o modelo câmeras dispositivo em devices/cameras/awJo6rH... por meio da API.

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

Nome

O nome de uma estrutura é padronizado como "Home", mas pode ser qualquer string que o usuário escolher.

name

Nestes exemplos, name é "andar de baixo" ou "andar de baixo (frente)".

uso do nomeuso do nome

name_long

O nome de exibição mais longo de um dispositivo. Neste exemplo, name_long é "escritório (Upstairs)".

name_long em uma mensagem

Onde

where_id

  • Um identificador exclusivo, gerado-Nest que representa name
  • where_id é só de leitura, e é criado automaticamente na chamada para criar um personalizado, onde name

Saiba mais sobre onde nomes para termostatos Ninho , Ninho Protege e ninho de webcams .

where_name

Quando você escolher a permissão Camera leitura , você pode acessar o dispositivo where_name do objeto de dispositivo ( devices/cameras ).

Recursos da câmera

Stream de vídeo

Transmissão ao vivo

Use estes URLs para acessar a página de transmissão ao vivo da web ou em um aplicativo:

Ativar / desativar streaming

Use o is_streaming campo para ligar a câmera ligada ou desligada.

  • Dependendo da rede doméstica do usuário e de sua implementação, pode haver um atraso no tempo de resposta
  • Você deve pedir permissão ao usuário para alterar o status de streaming (ligar / desligar a câmera)

Último evento

O last_event objeto é usado para obter links profundos para o último som detectado, movimento, ou evento pessoa, e acesso a imagem relacionada ou arquivo GIF.

Casos de uso típicos para o last_event/has_person domínio são luzes de gatilho, ou definir a roupa para um ciclo tranquila.

Segurança

Usando o last_event objeto e da estrutura away estado, da estrutura wwn_security_state valor pode escalar a partir ok para deter , o que pode desencadear outros dispositivos. Consulte o Guia de Segurança para recursos de dissuasão.

Usado para exibir o último evento registrado e requer que o usuário faça login na conta.

Arquivos de imagem ou GIF

Gato em uma cesta

Para que seu produto para acessar os últimos URLs de eventos, o usuário deve ter um papel activo Nest Aware subscrição, e você deve selecionar uma das Camera "+ imagens" permissões para o seu cliente.

Quando você faz uma chamada para image_url ou animated_image_url , você vai ter uma URL no seguinte formato:

"STRING1/device_id/STRING2?auth=camera_token"

Use este URL para visualizar uma imagem ou GIF.

Observe que os valores STRING são apenas para uso interno do Nest. Não altere os valores de STRING ou a chamada falhará.

Instantâneo sob demanda

Use este campo para obter um instantâneo da transmissão de vídeo ao vivo.

  • snapshot_url - retorna a URL de uma imagem capturada do fluxo de vídeo ao vivo
  • Requer que a câmera esteja ligada e transmitindo ativamente

A qualidade do instantâneo da API é de apenas 1080p se você:

  • visualizar ativamente o fluxo de câmera na aplicação ( web_url )
  • visualizar ativamente o fluxo de público ( app_url )
  • assinou Nest Aware

Se você não estiver visualizando o stream ativamente ou não tiver uma assinatura do Nest Aware, a API não tem uma fonte de 1080p para recuperar um instantâneo nessa resolução e gera uma imagem de qualidade inferior. Além disso, a baixa largura de banda da rede local pode fazer com que a resolução do instantâneo da API caia abaixo de 1080p com o Nest Aware presente.

Saiba mais sobre os requisitos de largura de banda para Nest câmeras .

Limites de taxa de instantâneo

Quando você faz uma chamada para obter o snapshot_url , aplicamos esses limites de frequência:

  • 2 / minuto para câmeras que não têm assinatura do Nest Aware
  • 10 / minuto para câmeras com assinatura do Nest Aware

Zonas de Atividade

Para que seu produto para acessar Zona Atividade informações, o usuário deve ter um papel activo Ciente Nest subscrição (a menos que seja um ninho Cam QI), e você deve selecionar uma das Camera "+ imagens" permissões para o seu cliente.

Quando há um evento de movimento, você pode ler os ids da zona de atividade onde o movimento ocorreu.

  • activity_zones -list de todos os nomes de zona, incluindo o nome definido pelo usuário e auto-gerado (s)
    • Exemplo de resposta: "activity_zones": [ {"name": "Porch", "id": 244083}, {"name": "Walkway", "id": 237084} ... ]
    • Neste exemplo, o usuário alterou o padrão "Zona 1" para "Porch" e "Zona 2" para "Passarela"
  • last_event/activity_zone_ids -list da zona de ids que detectaram o movimento durante o último evento
    • Exemplo resposta: "activity_zone_ids" : [ "237084", "244083" ]

URL de compartilhamento público

Use esses dois campos juntos para verificar se o usuário tornou a transmissão de vídeo pública e, em caso afirmativo, acesse esse URL.

Banner de backlink

Se você estiver criando um aplicativo para iOS 8 ou posterior, precisará adicionar backlinks ao usar a API da câmera.

Parâmetros

Nome Modelo Obrigatório Descrição
CUSTOM_SCHEME fragmento sim • Esquema de URL personalizado para seu aplicativo
Saiba mais sobre esquemas URI
APPNAME fragmento sim • Nome do seu aplicativo
• Exibido no banner de retorno
• Pode ser localizado
BACKLINK_PATH fragmento sim • Caminho de volta ao seu aplicativo
Saiba mais sobre backlinks

Faça a chamada

Ao criar um fluxo em que o usuário visualiza a transmissão de vídeo ao vivo ou um evento, inclua o caminho do backlink:

  1. Receba o app_url da API Nest. Deve ser algo como isto: "nestmobile://cameras/CjZHZ….7IYIm?auth=c.QbpCljxi5...Ny4gh&"
  2. Adicionar os seus parâmetros à app_url neste formato de string de consulta :
    "nestmobile://cameras/CjZHZ….7IYIm?auth=c.QbpCljxi5...Ny4gh&appname=APPNAME&backlink=CUSTOM_SCHEME://BACKLINK_PATH"

Mensagens de erro

Para obter informações sobre o que os erros de chamadas API significa e como lidar com eles, ver mensagens de erro .