Schema CameraClipPreview
Nest Doorbell (a batteria)
sdm.devices.traits.CameraClipPreview
Questo tratto appartiene a qualsiasi dispositivo che supporta il download di un'anteprima dei clip.
Campi
Nessun campo disponibile per questo tratto.
Comandi
Nessun comando disponibile per questo tratto.
Eventi
ClipPreview
Un video clip è disponibile per l'anteprima.
Un'anteprima di clip è un file video a 10 frame in formato mp4. Puoi scegliere di mostrare il file video mp4 o di transcodificarlo in un altro formato (ad esempio una GIF animata) al fine di mostrare una sequenza completa di 10 fotogrammi. Quando selezioni un metodo di anteprima dei 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 tratto CameraMotion | La videocamera ha rilevato un movimento. |
Evento | Evento Persona del tratto CameraPersona | La videocamera ha rilevato una persona. |
Evento | Evento Cicalino del tratto Cicalino Campanello | Il campanello è stato premuto. |
eventSessionId
per associare questo evento e i relativi previewUrl
a uno o più eventi supportati.
Evento ClipPreview
Payload
{ "eventId" : "0a88f94c-7b1d-48e8-9c42-e1a55ca0c0a1",
"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 nell'ambito di una singola sessione di e gli eventi correlati. Può essere utilizzato per raggruppare 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: "0a88f94c-7b1d-48e8-9c42-e1a55ca0c0a1" |
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 univoco offuscato che rappresenta l'utente. | string Esempio: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi" |
resourceGroup |
Un oggetto che indica risorse che potrebbero avere aggiornamenti simili a questo evento. La risorsa dell'evento stesso (dall'oggetto resourceUpdate ) sarà sempre presente in questo oggetto. |
object |
Consulta la sezione Eventi per ulteriori informazioni sulle diverse tipi di eventi e come funzionano.
Visualizza l'anteprima del clip
Per visualizzare l'anteprima del clip, effettua una chiamata GET al previewUrl
utilizzando il token di accesso OAuth nell'intestazione dell'autorizzazione HTTP:
Anteprima
curl -H 'Authorization: Bearer access-token' \
https://previewUrl/...
Errori
Consulta la documentazione sul codice di errore API per l'elenco completo dei codici di errore dell'API.