Esquema de CameraPerson

Nest Cam (heredado) Nest Cam (para exteriores o interiores, con batería) Nest Cam con reflector Nest Cam (para interiores, con cable) Nest Hub Max Nest Doorbell (heredado) Nest Doorbell (con batería) Nest Doorbell (con cable) 

sdm.devices.traits.CameraPerson

Esta característica pertenece a cualquier dispositivo que admita eventos de detección de personas.

Campos

No hay campos disponibles para este atributo.

Comandos

No hay comandos disponibles para este atributo.

Eventos

Persona

Actualizable 

La cámara detectó a una persona.

Este evento admite notificaciones actualizables. Las notificaciones de apps existentes creadas a partir de este evento se pueden actualizar con el contenido de un evento posterior con el mismo eventThreadId.

Evento de persona

Carga útil

{
  "eventId" : "d9a2b0e9-8578-46f8-899a-d741975d1c5b",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "QKlbpmRJYrfkoK3vyiiLoUuNry...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Campos de eventos de persona

Campo Descripción Tipo de datos
eventSessionId Nest Doorbell (con batería) Nest Doorbell (con cable) Un ID que se asigna a los eventos que ocurren como parte de una sola sesión de eventos relacionados. Se puede usar para consolidar eventos.

Úsalo para asociar este evento con el evento ClipPreview relacionado del atributo CameraClipPreview.

 string
Ejemplo: "CjY5Y3VKaTZwR3o4Y19YbTVfMF…"
eventId Nest Cam (heredado) Nest Hub Max Nest Doorbell (heredado) Un ID asociado con el evento.

Úsalo con el comando GenerateImage para descargar la imagen de la cámara relacionada con este evento.

 string
Ejemplo: "QKlbpmRJYrfkoK3vyiiLoUuNry…"

Campos de carga útil del evento

Campo Descripción Tipo de datos
eventId Es el identificador único del evento. string
Ejemplo: "d9a2b0e9-8578-46f8-899a-d741975d1c5b"
timestamp La hora en que ocurrió el evento. string
Ejemplo: “2019-01-01T00:00:01Z”
resourceUpdate Es un objeto que detalla la información sobre la actualización del recurso. object
userId Un identificador único y ofuscado que representa al usuario. string
Ejemplo: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
eventThreadId Actualizable Es el identificador único del subproceso del evento. string
Ejemplo: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState Actualizable Es el estado del subproceso del evento. string
Valores: "STARTED", "UPDATED", "ENDED"
resourceGroup Es un objeto que indica los recursos que podrían tener actualizaciones similares a este evento. El recurso del evento en sí (del objeto resourceUpdate) siempre estará presente en este objeto. object

Consulta Eventos para obtener más información sobre los diferentes tipos de eventos y cómo funcionan.

Errores

En relación con este atributo, se pueden mostrar los siguientes códigos de error:

Mensaje de error RPC Solución de problemas
La imagen de la cámara ya no está disponible para descargarla. DEADLINE_EXCEEDED Las imágenes de los eventos vencen 30 segundos después de que se publican. Asegúrate de descargar la imagen antes de que venza.
El ID del evento no pertenece a la cámara. FAILED_PRECONDITION Usa el eventID correcto que muestra el evento de la cámara.

Consulta la referencia de códigos de error de la API para obtener la lista completa de los códigos de error de la API.