Esquema de DoorbellChime

Nest Doorbell (heredado) Nest Doorbell (con batería) Nest Doorbell (con cable) 

sdm.devices.traits.DoorbellChime

Esta característica pertenece a cualquier dispositivo que admita una campanilla de timbre y eventos de prensa relacionados.

Campos

No hay campos disponibles para esta característica.

Comandos

No hay comandos disponibles para esta característica.

Eventos

Timbre

Actualizable 

Se presionó el timbre.

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 campanilla

Carga útil

{
  "eventId" : "f076b1cd-b1ae-45dc-abf0-98b7a7e99be8",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "HLgoTj0dIJOtBjcaeB44zU6ERP..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Campos de eventos de la campanilla

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

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

 string
Ejemplo: “CjY5Y3VKaTZwR3o4Y19YbTVfMF...”
eventId Nest Doorbell (heredado) Es un ID asociado con el evento.

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

 string
Ejemplo: "HLgoTj0dIJOtBjcaeB44zU6ERP..."

Campos de carga útil del evento

Campo Descripción Tipo de datos
eventId Es el identificador único del evento. string
Ejemplo: "f076b1cd-b1ae-45dc-abf0-98b7a7e99be8"
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 Es el identificador único del subproceso del evento. string
Ejemplo: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState Updateable Es el estado del subproceso del evento. 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 Solución de 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.