Schema CameraClipPreview
Nest Doorbell (a batteria)
sdm.devices.traits.CameraClipPreview
Questo trait appartiene a qualsiasi dispositivo che supporta il download di un'anteprima dei clip.
Campi
Non ci sono campi disponibili per questo trait.
Comandi
Nessun comando disponibile per questo trait.
Eventi
ClipPreview
Un video clip è disponibile per l'anteprima.
Un'anteprima di clip è un file video di 10 fotogrammi in formato mp4. Puoi scegliere di mostrare il file video mp4 o di transcodificarlo in un altro formato (ad esempio, una GIF animata) per mostrare una sequenza completa di 10 fotogrammi. Quando selezioni un metodo di anteprima della clip, devi prendere in considerazione le funzionalità del client del dispositivo.
Questo evento è supportato per i seguenti eventi:
Tipo | Elemento | Descrizione |
---|---|---|
Evento | Evento Movimento del trait CameraMotion | La videocamera ha rilevato un movimento. |
Evento | Evento Persona del tratto CameraPerson | La videocamera ha rilevato una persona. |
Evento | Evento Segnale acustico del trait DoorbellChime | Il campanello è stato premuto. |
eventSessionId
per associare questo evento e il relativo previewUrl
a uno o più eventi supportati.
Evento ClipPreview
Payload
{ "eventId" : "54e55063-25e6-44a5-9aa7-704405bb1c91",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.CameraClipPreview.ClipPreview
" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "previewUrl" : "https://previewUrl/..." } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }
Campi evento ClipPreview
Campo | Descrizione | Tipo di dati |
---|---|---|
eventSessionId |
Un ID assegnato agli eventi che si verificano come parte di una singola sessione di eventi correlati. Possono essere utilizzate per consolidare gli eventi. | string Esempio: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..." |
previewUrl |
L'URL in cui visualizzare l'anteprima del video clip. Il codec video predefinito è H264. | string Esempio: "https://previewUrl/..." |
Campi payload evento
Campo | Descrizione | Tipo di dati |
---|---|---|
eventId |
L'identificatore univoco dell'evento. | string Esempio: "54e55063-25e6-44a5-9aa7-704405bb1c91" |
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 ulteriori informazioni sui diversi tipi di eventi e sul loro funzionamento, consulta la sezione Eventi.
Visualizza l'anteprima del clip
Per visualizzare l'anteprima del clip, effettua una chiamata GET a previewUrl
utilizzando il token di accesso OAuth nell'intestazione Authorization HTTP:
Anteprima
curl -H 'Authorization: Bearer access-token' \
https://previewUrl/...
Errori
Consulta la pagina Riferimento sui codici di errore API per l'elenco completo dei codici di errore API.