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.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Cámara

Nest Cam

Nest Cam ™ es un dispositivo conectado a Internet que es intuitivo y fácil de usar. Aprende continuamente sobre los patrones de uso en el hogar para ahorrar energía y optimizar la seguridad y la comodidad. Los usuarios pueden controlar Nest Cam desde cualquier lugar donde tengan acceso a una conexión a Internet.

Nest API proporciona acceso a los siguientes datos en Nest Cam, dependiendo del nivel de permisos otorgados:

  • Nombre de la estructura y dispositivo "nombre del lugar" (ubicación en el hogar)
  • Estado en línea de la cámara o estado del micrófono
  • Estado de transmisión (activar / desactivar la transmisión de video)
  • Nombre del dispositivo y donde identificador
  • Último cambio de estado en línea (último cambio en línea / fuera de línea)
  • Estado de suscripción de Nest Aware (inscrito / no inscrito)
  • Enlaces profundos a la alimentación de la cámara en vivo en la aplicación Nest (iOS, Android) o en la web en home.nest.com
  • Contenido relacionado con el último evento que activó una notificación, que incluye:
    • Evento de sonido o movimiento detectado
    • Hora de inicio / parada del evento
    • Enlaces profundos a archivos de imagen y gif
  • Instantáneas de imagen a pedido
  • Estado de uso compartido y URL de uso compartido público
  • Nombres de zonas de actividad , y cuando hay un evento de movimiento, los identificadores donde ocurrió el movimiento (Requiere Nest Aware )

Tipos de cámara

Nest API admite varios tipos de cámaras:

  • Nest Cam Indoor: la cámara Nest original para interiores
  • Nest Cam Outdoor: la cámara Nest original para exteriores
  • Nest Cam IQ Indoor: cámara Nest interior con potencia de procesamiento adicional, que permite funciones sofisticadas de reconocimiento, bocina e instantánea
  • Nest Cam IQ Outdoor: cámara Nest para exteriores con potencia de procesamiento adicional, que permite funciones sofisticadas de reconocimiento, bocina e instantánea
  • Nest Hello: una cámara que funciona como un timbre de video

Tenga en cuenta que todas las cámaras Nest aparecen en la API de la misma manera. En el caso de Nest Hello, solo la parte de la cámara del dispositivo aparece en la API de Nest. La funcionalidad de timbre más allá de la cámara no está disponible en la API.

Permisos de la cámara

Los siguientes niveles de permisos de acceso están disponibles para Nest Cam:



Acceso
Permisos
Lectura de la cámara

Cámara de lectura / escritura

Lectura de cámara + imágenes

Cámara de lectura / escritura + imágenes
Puede leer todos los valores, excepto :
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
si si
Puede leer todos los valores. si si
Puede escribir is_streaming (cámara encendida / apagada)
• Este cambio de estado requiere un acuerdo explícito del usuario
si si

Para obtener más información, consulte la Descripción general de los permisos .

Identificadores de cámara

Dispositivo

Los dispositivos Nest se enumeran por tipo como una matriz de ID, que se pueden utilizar para identificar de forma única un dispositivo a través de la ruta del dispositivo. Por lo tanto, una ID de cámara de "awJo6rH..." significa que puede cargar el modelo de dispositivo de la cámara en devices/cameras/awJo6rH... través de la API.

Cuando un dispositivo está conectado a varios productos, cada desarrollador verá una ID diferente para ese dispositivo. Para un dispositivo que ha instalado varios productos del mismo desarrollador, el desarrollador verá la misma ID.

Nombre

El nombre de una estructura por defecto es "Inicio" pero puede ser cualquier cadena que el usuario elija.

name

En estos ejemplos, el name es "Abajo" o "Abajo (Puerta principal)".

uso de nombreuso de nombre

name_long

El nombre para mostrar más largo para un dispositivo. En este ejemplo, name_long es "Office (Upstairs)".

name_long en un mensaje

Dónde

where_id

  • Un identificador único generado por Nest que representa el name
  • where_id es de solo lectura y se crea automáticamente en la llamada para crear un name personalizado donde

Obtén más información sobre dónde están los nombres de los termostatos Nest , Nest Protects y Nest Cams .

where_name

Cuando elige el permiso de lectura de la cámara , puede acceder al dispositivo where_name desde el objeto del dispositivo ( devices/cameras ).

Características de la cámara

Video en directo

Transmisión en vivo

Use estas URL para acceder a la página de transmisión en vivo desde la web o en una aplicación:

Activar / desactivar la transmisión

Use el campo is_streaming para encender o apagar la cámara.

  • Dependiendo de la red doméstica del usuario y su implementación, puede haber un retraso en el tiempo de respuesta
  • Debe pedirle al usuario permiso para cambiar el estado de transmisión (encienda / apague la cámara)

Último evento

El objeto last_event se usa para obtener enlaces profundos al último sonido, movimiento o evento de persona detectado, y acceder a la imagen relacionada o al archivo GIF.

Los casos de uso típicos para el campo last_event/has_person son para encender luces o configurar la ropa en un ciclo silencioso.

Seguridad

Al usar el objeto last_event y el estado de away la estructura, el valor wwn_security_state la estructura puede aumentar de ok a deter , lo que puede activar otros dispositivos. Consulte la Guía de seguridad para conocer las características de disuasión.

Se usa para mostrar el último evento registrado y requiere que el usuario inicie sesión en la cuenta.

Imagen o archivos GIF

Gato en una cesta

Para que su producto acceda a las URL de los últimos eventos, el usuario debe tener una suscripción Nest Aware activa y debe seleccionar uno de los permisos de cámara "+ imágenes" para su cliente.

Cuando realiza una llamada para image_url o animated_image_url , obtendrá una URL en este formato:

"STRING1/device_id/STRING2?auth=camera_token"

Use esta URL para ver una imagen o GIF.

Tenga en cuenta que los valores de STRING son solo para uso interno de Nest. No cambie los valores de STRING, o la llamada fallará.

Instantánea bajo demanda

Use este campo para obtener una instantánea de la transmisión de video en vivo.

  • snapshot_url : devuelve la URL de una imagen capturada de la transmisión de video en vivo
  • Requiere que la cámara esté encendida y transmitiendo activamente

La calidad de la instantánea de la API es de solo 1080p si usted es:

  • Ver activamente la transmisión de la cámara en la aplicación ( web_url )
  • Ver activamente la transmisión pública ( app_url )
  • suscrito a Nest Aware

Si no está viendo activamente la transmisión o no tiene una suscripción a Nest Aware, la API no tiene una fuente de 1080p para recuperar una instantánea con esa resolución y genera una imagen de menor calidad. Además, el bajo ancho de banda de la red local puede hacer que la resolución de la instantánea de la API baje a menos de 1080p con Nest Aware presente.

Obtenga más información sobre los requisitos de ancho de banda para cámaras Nest .

Límites de velocidad de instantáneas

Cuando realiza una llamada para obtener la snapshot_url , aplicamos estos límites de velocidad:

  • 2 / minuto para cámaras que no tienen una suscripción Nest Aware
  • 10 / minuto para cámaras que tienen una suscripción Nest Aware

Zonas de actividad

Para que su producto acceda a la información de la Zona de actividad , el usuario debe tener una suscripción Nest Aware activa (a menos que sea un Nest Cam IQ), y debe seleccionar uno de los permisos de cámara "+ imágenes" para su cliente.

Cuando hay un evento de movimiento, puede leer los identificadores de zona de actividad donde ocurrió el movimiento.

  • activity_zones lista de todos los nombres de zonas, incluidos los nombres definidos por el usuario y autogenerados
    • Respuesta de ejemplo: "activity_zones": [ {"name": "Porch", "id": 244083}, {"name": "Walkway", "id": 237084} ... ]
    • En este ejemplo, el usuario cambió la "Zona 1" predeterminada a "Porche" y la "Zona 2" a "Pasarela"
  • last_event/activity_zone_ids lista de identificadores de zona que detectaron movimiento durante el último evento
    • Respuesta de ejemplo: "activity_zone_ids" : [ "237084", "244083" ]

URL de recurso público

Use estos dos campos juntos para verificar si el usuario ha hecho pública la transmisión de video y, de ser así, acceda a esa URL.

Banner de vínculo de retroceso

Si está creando una aplicación para iOS 8 o posterior, deberá agregar vínculos de retroceso cuando use la API de la cámara.

Parámetros

Nombre Tipo Necesario Descripción
CUSTOM_SCHEME cuerda si • Esquema de URL personalizado para su aplicación
Obtenga más información sobre los esquemas de URI
APPNAME cuerda si • Nombre de tu aplicación
• Se muestra en el banner de devolución
• Puede ser localizado
BACKLINK_PATH cuerda si • Ruta de regreso a su aplicación
Obtenga más información sobre los vínculos de retroceso

Haz la llamada

Cuando cree un flujo en el que su usuario vea la transmisión de video en vivo o un evento, incluya la ruta del vínculo de retroceso:

  1. Recibe el app_url de la API de Nest. Debería verse así: "nestmobile://cameras/CjZHZ….7IYIm?auth=c.QbpCljxi5...Ny4gh&"
  2. Agregue sus parámetros a app_url en este formato de cadena de consulta :
    "nestmobile://cameras/CjZHZ….7IYIm?auth=c.QbpCljxi5...Ny4gh&appname=APPNAME&backlink=CUSTOM_SCHEME://BACKLINK_PATH"

Error de mensajes

Para obtener información sobre qué significan los errores de llamadas de API y cómo manejarlos, consulte Mensajes de error .