Esquema CameraPerson
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 esta característica.
Comandos
No hay comandos disponibles para esta característica.
Eventos
Persona
ActualizableLa cámara detectó a una persona.
Este evento admite notificaciones que se pueden actualizar. 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" : "93615880-119c-48b2-a320-26030ba572d7",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.CameraPerson.Person
" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "rdCPMZ-LLGz1rXqctRhov_nHV_...", } } } "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) Úsalo para asociar este evento con el evento ClipPreview relacionado del trait CameraClipPreview. |
string Ejemplo: “CjY5Y3VKaTZwR3o4Y19YbTVfMF...” |
eventId |
Nest Cam (heredado) Úsala con el comando GenerateImage para descargar la imagen de la cámara relacionada con este evento. |
string Ejemplo: “rdCPMZ-LLGz1rXqctRhov_nHV_...” |
Campos de carga útil del evento
Campo | Descripción | Tipo de datos |
---|---|---|
eventId |
Es el identificador único del evento. | string Ejemplo: “93615880-119c-48b2-a320-26030ba572d7” |
timestamp |
Indica la hora a la que ocurrió el evento. | string Ejemplo: “2019-01-01T00:00:01Z” |
resourceUpdate |
Un objeto que detalla información sobre la actualización del recurso. | object |
userId |
Es un identificador único y ofuscado que representa al usuario. | string Ejemplo: “AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi” |
eventThreadId |
Actualizable |
string Ejemplo: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59" |
eventThreadState |
Updateable |
string Valores: "STARTED", "UPDATED", "ENDED" |
resourceGroup |
Un objeto que indica recursos que pueden tener actualizaciones similares a este evento. El recurso del evento (del objeto resourceUpdate ) siempre estará presente en este objeto. |
object |
Consulta Eventos para obtener más información sobre los diferentes de eventos y cómo funcionan.
Errores
Se pueden mostrar los siguientes códigos de error en relación con esta característica:
Mensaje de error | RPC | Soluciona problemas |
---|---|---|
La imagen de la cámara ya no está disponible para descargar. | DEADLINE_EXCEEDED |
Las imágenes del evento vencen 30 segundos después de que se publica el evento. Asegúrate de descargar la imagen antes del vencimiento. |
El ID de 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 API para la lista completa de códigos de error de API.