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.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

Câmera

Nest Cam

O Nest Cam ™ é um dispositivo conectado à Internet, 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 o Nest Cam de qualquer lugar em que tenham acesso a uma conexão com a Internet.

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

  • Nome da estrutura e dispositivo "where name" (localização na casa)
  • Status online da câmera ou status do microfone
  • Status do streaming (ativar / desativar o streaming de vídeo)
  • Nome do dispositivo e identificador de onde
  • Última alteração de status online (última alteração online / offline)
  • Status da assinatura do Nest Aware (inscrito / não inscrito)
  • Links diretos para o feed da 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ário de início / parada do evento
    • Links diretos para arquivos de imagem e gif
  • Instantâneos de imagem sob demanda
  • Status de compartilhamento e URL de compartilhamento público
  • Nomes das zonas de atividade e, quando houver um evento de movimento, os IDs em que o movimento ocorreu (requer Nest Aware )

Tipos de câmera

A API do Nest suporta vários tipos de câmera:

  • Nest Cam Indoor - a câmera Nest interna original
  • Nest Cam Outdoor - a câmera original para o exterior da Nest
  • Nest Cam IQ Indoor - câmera Nest interna com poder de processamento adicional, permitindo recursos sofisticados de reconhecimento, alto-falante e instantâneo
  • Nest Cam IQ Outdoor - câmera Nest externa com poder de processamento adicional, permitindo recursos sofisticados de reconhecimento, alto-falante e 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 do Nest. A funcionalidade de campainha além da câmera não está disponível na API.

Permissões da câmera

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



Acesso
Permissões
Leitura da câmera

Leitura / gravação da câmera

Câmera ler + 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 ligada / desligada)
• Essa alteração de status requer um acordo explícito do usuário
sim sim

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

Identificadores de câmera

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 câmera "awJo6rH..." significa que você pode carregar o modelo de dispositivo das câmeras em devices/cameras/awJo6rH... 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

O nome de uma estrutura é padronizado como "Início", mas pode ser qualquer sequência que o usuário escolher.

name

Nestes exemplos, o name é "Downstairs" ou "Downstairs (Door Front)".

uso de nomeuso de nome

name_long

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

name_long em uma mensagem

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 da câmera , você pode acessar o dispositivo where_name partir do objeto do dispositivo ( devices/cameras ).

Recursos da câmera

Transmissão de vídeo

Transmissão ao vivo

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

Ativar / desativar o streaming

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

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

Último evento

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

Os casos de uso típicos do campo last_event/has_person são acionar luzes ou definir a roupa para um ciclo silencioso.

Segurança

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

Usado para exibir o último evento gravado e requer que o usuário esteja conectado à conta.

Arquivos de imagem ou GIF

Gato em uma cesta

Para que seu produto acesse os URLs do último evento, o usuário deve ter uma assinatura ativa do Nest Aware e você deve selecionar uma das permissões "+ imagens" da câmera para o seu cliente.

Ao fazer uma chamada para image_url ou animated_image_url , você obterá um URL neste 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 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 o URL de uma imagem capturada do fluxo de vídeo ao vivo
  • Requer que a câmera esteja ligada e transmitindo ativamente

A qualidade da captura instantânea da API é de apenas 1080p, se você:

  • visualizando ativamente o fluxo da câmera no aplicativo ( web_url )
  • visualizando ativamente o fluxo público ( app_url )
  • inscrito em Nest Aware

Se você não estiver exibindo ativamente o fluxo ou não tiver uma assinatura do Nest Aware, a API não terá uma fonte de 1080p a partir da qual recuperar um instantâneo com essa resolução e gerar 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 as câmeras Nest .

Limites da taxa de captura instantânea

Quando você faz uma chamada para obter o snapshot_url , aplicamos estes limites de taxa:

  • 2 / minuto para câmeras que não possuem uma assinatura Nest Aware
  • 10 / minuto para câmeras com assinatura Nest Aware

Zonas de atividade

Para que seu produto acesse as informações da Zona de Atividade , o usuário deve ter uma assinatura ativa do Nest Aware (a menos que seja um Nest Cam IQ) e você deve selecionar uma das permissões "+ imagens" da câmera para o seu cliente.

Quando há um evento de movimento, você pode ler os IDs da zona de atividade em que o movimento ocorreu.

  • activity_zones de todos os nomes de zonas, incluindo nomes definidos pelo usuário e gerados automaticamente
    • Resposta de exemplo: "activity_zones": [ {"name": "Porch", "id": 244083}, {"name": "Walkway", "id": 237084} ... ]
    • Neste exemplo, o usuário alterou a "Zona 1" padrão para "Varanda" e "Zona 2" para "Passagem"
  • last_event/activity_zone_ids de IDs de zona que detectaram movimento durante o último evento
    • Resposta de exemplo: "activity_zone_ids" : [ "237084", "244083" ]

URL de compartilhamento público

Use esses dois campos juntos para verificar se o usuário tornou público o fluxo de vídeo 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 Tipo Requeridos Descrição
CUSTOM_SCHEME corda sim • Esquema de URL personalizado para seu aplicativo
Saiba mais sobre esquemas de URI
APPNAME corda sim • nome do seu aplicativo
• Exibido no banner de retorno
• pode ser localizado
BACKLINK_PATH corda sim • Caminho de volta para seu aplicativo
Saiba mais sobre backlinks

Faça a chamada

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

  1. Receba o app_url da API do Nest. Deve ser algo como isto: "nestmobile://cameras/CjZHZ….7IYIm?auth=c.QbpCljxi5...Ny4gh&"
  2. Adicione seus parâmetros ao 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 significado dos erros de chamada da API e como lidar com eles, consulte Mensagens de erro .