Schema CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

Questo attributo appartiene a qualsiasi dispositivo che supporta il download dell'anteprima di un clip.

Campi

Non sono disponibili campi per questa caratteristica.

Comandi

Non sono disponibili comandi per questa funzionalità.

Eventi

ClipPreview

È disponibile un'anteprima di un video clip.

L'anteprima di un 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 frame. Le funzionalità del client del dispositivo devono essere prese in considerazione quando si seleziona un metodo di anteprima del clip.

Questo evento è supportato per i seguenti eventi:

Tipo Elemento Descrizione
Evento Evento Motion del tratto CameraMotion La videocamera ha rilevato un movimento.
Evento Evento Persona del trait CameraPerson La videocamera ha rilevato una persona.
Evento Evento Chime del tratto DoorbellChime Il campanello è stato premuto.
Utilizza eventSessionId per associare questo evento e il relativo previewUrl a uno o più eventi supportati.

Evento ClipPreview

Payload

{
  "eventId" : "b57d00e5-ea8e-4c8d-a130-99b8f2525384",
  "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 il consolidamento degli eventi. string
Esempio: "CjY5Y3VKaTZwR3o4Y19YbTVfMF…"
previewUrl L'URL da cui visualizzare l'anteprima del video clip. Il codec video predefinito è H264. string
Esempio: "https://previewUrl/…"

Campi del payload dell'evento

Campo Descrizione Tipo di dati
eventId L'identificatore univoco dell'evento. string
Esempio: "b57d00e5-ea8e-4c8d-a130-99b8f2525384"
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"
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 di autorizzazione HTTP:

Anteprima

curl -H 'Authorization: Bearer access-token' \
  https://previewUrl/...

Errori

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