Schema DoorbellChime

Nest Doorbell (versione precedente) Nest Doorbell (a batteria) Nest Doorbell (con cavo) 

sdm.devices.traits.DoorbellChime

Questo trait appartiene a qualsiasi dispositivo che supporta un cicalino del campanello e gli eventi di stampa correlati.

Campi

Non ci sono campi disponibili per questo trait.

Comandi

Nessun comando disponibile per questo trait.

Eventi

Cicalino

Aggiornabili 

Il campanello è stato premuto.

Questo evento supporta le notifiche aggiornabili. Le notifiche delle app esistenti create da questo evento possono essere aggiornate utilizzando i contenuti di un evento successivo con lo stesso eventThreadId.

Evento cicalino

Payload

{
  "eventId" : "854a3723-c351-45df-95e9-aed6004c1352",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "mq-qjzq6wgrOPERrPw7OMmBZPN..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Campi relativi agli eventi del cicalino

Campo Descrizione Tipo di dati
eventSessionId Nest Doorbell (a batteria) Nest Doorbell (con cavo) Un ID assegnato a eventi che si verificano nell'ambito di una singola sessione di eventi correlati. Possono essere utilizzate per consolidare gli eventi.

Utilizzalo per associare questo evento al relativo evento ClipPreview del trait CameraClipPreview.

 string
Esempio: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId Nest Doorbell (legacy) Un ID associato all'evento.

Utilizzalo con il comando GeneraImage per scaricare l'immagine della videocamera relativa all'evento.

 string
Esempio: "mq-qjzq6wgrOPERrPw7OMmBZPN..."

Campi payload evento

Campo Descrizione Tipo di dati
eventId L'identificatore univoco dell'evento. string
Esempio: "854a3723-c351-45df-95e9-aed6004c1352"
timestamp L'ora in cui si è verificato l'evento. string
Esempio: "2019-01-01T00:00:01Z"
resourceUpdate Un oggetto che descrive in dettaglio le informazioni sull'aggiornamento della risorsa. object
userId Un identificatore univoco e offuscato che rappresenta l'utente. string
Esempio: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
eventThreadId Aggiornabile L'identificatore univoco del thread di eventi. string
Esempio: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState Aggiornabile Lo stato del thread dell'evento. string
Valori: "STARTED", "UPDATED", "ENDED"
resourceGroup Un oggetto che indica le risorse che potrebbero avere aggiornamenti simili a questo evento. La risorsa dell'evento stesso (dall'oggetto resourceUpdate) sarà sempre presente in questo oggetto. object

Per ulteriori informazioni sui diversi tipi di eventi e sul loro funzionamento, consulta la sezione Eventi.

Errori

In relazione a questa caratteristica, potrebbero essere restituiti i seguenti codici di errore:

Messaggio di errore RPC Risoluzione dei problemi
L'immagine della fotocamera non è più disponibile per il download. DEADLINE_EXCEEDED Le immagini degli eventi scadono 30 secondi dopo la loro pubblicazione. Assicurati di scaricare l'immagine prima della scadenza.
L'ID evento non appartiene alla videocamera. FAILED_PRECONDITION Usa il valore eventID corretto restituito dall'evento della videocamera.

Consulta la pagina Riferimento sui codici di errore API per l'elenco completo dei codici di errore API.