Schema CameraClipPreview

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

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.
Utilizza l'attributo eventSessionId per associare questo evento e i relativi previewUrl a uno o più eventi supportati.

Evento ClipPreview

Payload

{
  "eventId" : "512b58f4-6325-4bf6-92bb-de52acf1c2c8",
  "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 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: "512b58f4-6325-4bf6-92bb-de52acf1c2c8"
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

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

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 pagina Riferimento per i codici di errore API per l'elenco completo dei codici di errore delle API.