Cámara

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 la Nest Cam desde cualquier lugar donde tengan acceso a una conexión a Internet.

La API Nido proporciona acceso a los siguientes datos sobre Nest Cam, depende del nivel de permisos concedidos:

• Nombre de la estructura y dispositivo "donde nombre" (ubicación en la casa)
• Estado de la cámara en línea o estado del micrófono
• Estado de transmisión (activar / desactivar la transmisión de video)
• Nombre del dispositivo e identificador de dónde
• Último cambio de estado en línea (último cambio en línea / fuera de línea)
• Nest Aware estado de suscripción (inscrito / no inscrito)
• Los enlaces profundos a la alimentación de la cámara en directo en la aplicación de Nest (iOS, Android) o en la web en home.nest.com
• Contenido relacionado con el último evento que provocó una notificación, que incluye:
  • Se detectó un evento de sonido o movimiento
  • Horas de inicio / finalización del evento
  • Vínculos profundos a archivos de imagen y gif
• Instantáneas de imágenes bajo demanda
• Compartir el estado y la dirección URL pública de acciones
• Zona de Actividades nombres, y cuando hay un evento de movimiento, los identificadores de donde se produjo el movimiento (Requiere Nest Aware )

Tipos de cámara

La API de Nest 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 para interiores: cámara Nest para interiores con potencia de procesamiento adicional, que permite funciones sofisticadas de reconocimiento, altavoz e instantáneas
• Nest Cam IQ Outdoor: cámara Nest para exteriores con potencia de procesamiento adicional, que permite funciones sofisticadas de reconocimiento, altavoz e instantánea
• Nest Hello: una cámara que funciona como 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 del 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	Lectura / escritura de la cámara	Imágenes de camera read	Cámara + 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	sí	sí
Puede leer todos los valores			sí	sí
Puede escribir is_streaming (cámara de encendido / apagado) • Este cambio de estado requiere un acuerdo explícito del usuario		sí		sí

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

Identificadores de cámara

Dispositivo

Los dispositivos Nest se enumeran por tipo como una serie de ID, que se pueden usar para identificar de forma única un dispositivo a través de la ruta del dispositivo. Por lo que un ID de la cámara de "awJo6rH..." significa que se pueden cargar el modelo de dispositivo cámaras en devices/cameras/awJo6rH... a 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á el mismo ID.

Nombre

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

name

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

name_long

El nombre de visualización más largo de un dispositivo. En este ejemplo, name_long es "Oficina (Arriba)".

Dónde

where_id

• Un identificador único, generado Nest-que representa name
• where_id es de sólo lectura, y se crea automáticamente en la llamada para crear una costumbre en name

Más información sobre dónde nombres para termostatos Nest , Nido Protege y Nido de levas .

where_name

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

Características de la cámara

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:

• web_url
• app_url

Activar / desactivar la transmisión

Usar la is_streaming campo para encender la cámara encendida o apagada.

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

Último evento

El last_event objeto se utiliza para conseguir enlaces profundos a la última sonido detectado, movimiento, o evento persona, y acceso a la imagen relacionada o GIF.

Casos de uso típicos para la last_event/has_person campo son a las luces de activación, o conjunto la ropa a un ciclo tranquilo.

Seguridad

Uso de la last_event objeto y de la estructura away estado, de la estructura wwn_security_state valor puede escalar de ok a deter , que puede accionar otros dispositivos. Consulte la Guía de seguridad para las características de disuasión.

Vínculos profundos (URL de la web o de la aplicación)

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

• last_event/web_url
• last_event/app_url

Archivos de imagen o GIF

Para que su producto para acceder a los últimos URL de eventos, el usuario debe tener una activa Consciente Nido de suscripción, y deberá seleccionar uno de la cámara "+" permisos imágenes para su cliente.

• last_event/image_url
• last_event/animated_image_url

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

"STRING1/device_id/STRING2?auth=camera_token"

Utilice esta URL para ver una imagen o un 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

Utilice 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 secuencia de vídeo en directo
• Requiere que la cámara esté encendida y transmitiendo activamente

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

• viendo activamente el flujo de la cámara en la aplicación ( web_url )
• viendo activamente el flujo de público ( 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 desde la cual recuperar una instantánea con esa resolución y genera una imagen de menor calidad. Además, un ancho de banda de red local bajo puede hacer que la resolución de la instantánea de la API caiga por debajo de 1080p con Nest Aware presente.

Más información sobre los requisitos de ancho de banda para Cámaras Nido .

Límites de frecuencia de instantáneas

Cuando realiza una llamada para obtener el snapshot_url , aplicamos estos límites de frecuencia:

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

Zonas de actividad

Para que su producto para acceder a la Zona de Actividad información, el usuario debe tener una sesión Consciente Nido de suscripción (a menos que sea un nido Cam CI), y deberá seleccionar uno de la cámara "+" imágenes permisos para su cliente.

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

• activity_zones -list de todos los nombres de zona, incluyendo el nombre definido por el usuario y auto-generado (s)
  • Ejemplo de respuesta: "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 -list de identificadores de zona que detecta movimiento durante el último evento
  • Ejemplo de respuesta: "activity_zone_ids" : [ "237084", "244083" ]

URL compartida pública

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.

• is_public_share_enabled -boolean, devoluciones true si el flujo de vídeo es público, false si privada
• public_share_url -URL de la corriente pública compartida

Vínculos de retroceso de iOS

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	Requerido	Descripción
CUSTOM_SCHEME	cuerda	sí	• Esquema de URL personalizado para su aplicación • Más información sobre esquemas URI
APPNAME	cuerda	sí	• Nombre de su aplicación • Se muestra en el banner de devolución. • Puede ser localizado
BACKLINK_PATH	cuerda	sí	• Ruta de regreso a su aplicación • 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. Recibir el app_url de la API Nido. Debe ser algo como esto: "nestmobile://cameras/CjZHZ….7IYIm?auth=c.QbpCljxi5...Ny4gh&"
2. Añadir sus parámetros a la 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 lo que los errores de llamada a la API significan y cómo manejarlos, ver los mensajes de error .