Schema CameraPerson

Nest Cam (legacy) Nest Cam (per esterni o interni, a batteria) Nest Cam con faretto Nest Cam (per interni, con cavo) Nest Hub Max Nest Doorbell (legacy) Nest Doorbell (a batteria) Nest Doorbell (con cavo) 

sdm.devices.traits.CameraPerson

Questa caratteristica appartiene a qualsiasi dispositivo che supporta gli eventi di rilevamento delle persone.

Campi

Non sono disponibili campi per questa caratteristica.

Comandi

Non sono disponibili comandi per questa funzionalità.

Eventi

Persona

Aggiornabile 

La videocamera ha rilevato una persona.

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 Persona

Payload

{
  "eventId" : "64d32b1b-c1fc-4c60-ab05-8f4858d9aeea",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "e2UB-0IXavhVh3hW5zQmlj55nK...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Campi evento Persona

Campo Descrizione Tipo di dati
eventSessionId Nest Doorbell (a batteria) Nest Doorbell (con cavo) Un ID assegnato agli eventi che si verificano nell'ambito di una singola sessione di eventi correlati. Può essere utilizzato per il consolidamento degli eventi.

Utilizzalo per associare questo evento all'evento ClipPreview correlato del tratto CameraClipPreview.

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

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

 string
Esempio: "e2UB-0IXavhVh3hW5zQmlj55nK…"

Campi del payload dell'evento

Campo Descrizione Tipo di dati
eventId L'identificatore univoco dell'evento. string
Esempio: "64d32b1b-c1fc-4c60-ab05-8f4858d9aeea"
timestamp L'ora in cui si è verificato l'evento. string
Esempio: "2019-01-01T00:00:01Z"
resourceUpdate Un oggetto che fornisce informazioni dettagliate sull'aggiornamento della risorsa. object
userId Un identificatore offuscato univoco 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 questo attributo, 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 pubblicazione dell'evento. Assicurati di scaricare l'immagine prima della scadenza.
L'ID evento non appartiene alla videocamera. FAILED_PRECONDITION Utilizza il valore eventID corretto restituito dall'evento della videocamera.

Consulta il riferimento ai codici di errore dell'API per un elenco completo dei codici di errore dell'API.