Schema CameraSound

Nest Cam (legacy) Nest Hub Max Nest Doorbell (legacy) 

sdm.devices.traits.CameraSound

Questo tratto appartiene a qualsiasi dispositivo che supporta gli eventi di rilevamento dei suoni.

Campi

Non sono disponibili campi per questo tratto.

Comandi

Non sono disponibili comandi per questo tratto.

Eventi

Suono

La videocamera ha rilevato un suono.

Evento sonoro

Payload

{
  "eventId" : "9b6d812f-5955-455d-ac4b-d1af9218982a",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraSound.Sound" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "T1o0r_v_o8iYSBxXA4BznQExGa..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Campi degli eventi sonori

Campo Descrizione Tipo di dati
eventSessionId Un ID assegnato agli eventi che si verificano nell'ambito di una singola sessione di eventi correlati. Può essere utilizzato per consolidare gli eventi. string
Esempio: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId Un ID associato all'evento.

Utilizzalo con il comando GenerateImage per scaricare l'immagine della videocamera relativa a questo evento.

 string
Esempio: "T1o0r_v_o8iYSBxXA4BznQExGa..."

Campi del payload evento

Campo Descrizione Tipo di dati
eventId L'identificatore univoco dell'evento. string
Esempio: "9b6d812f-5955-455d-ac4b-d1af9218982a"
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"
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 saperne di più sui diversi tipi di eventi e sul loro funzionamento, consulta la sezione Eventi.

Errori

Per questo attributo potrebbero essere restituiti i seguenti codici di errore:

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

Consulta i riferimenti ai codici di errore dell'API per l'elenco completo dei codici di errore dell'API.