Schema di CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

Questa caratteristica appartiene a qualsiasi dispositivo che supporta il download di un'anteprima della clip.

Campi

Non sono disponibili campi per questa caratteristica.

Comandi

Non sono disponibili comandi per questa caratteristica.

Eventi

ClipPreview

È disponibile un video clip per l'anteprima.

Un'anteprima della 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 tenere conto delle funzionalità del client del dispositivo.

Questo evento è supportato per i seguenti eventi:

Tipo	Elemento	Descrizione
Evento	Evento di movimento della caratteristica CameraMotion	La videocamera ha rilevato un movimento.
Evento	Evento di persona della caratteristica CameraPerson	La videocamera ha rilevato una persona.
Evento	Evento cicalino della caratteristica DoorbellChime	È stato premuto il campanello.

Utilizza eventSessionId per associare questo evento e il previewUrl correlato a uno o più eventi supportati.

Evento ClipPreview

Payload

{
  "eventId" : "c4c7432d-0048-4501-b5f5-94a7d95f70b3",
  "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 dell'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 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 dell'evento

Campo	Descrizione	Tipo di dati
`eventId`	L'identificatore univoco dell'evento.	`string` Esempio: "c4c7432d-0048-4501-b5f5-94a7d95f70b3"
`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 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 saperne di più sui diversi tipi di eventi e sul loro funzionamento, consulta la pagina Eventi.

Visualizzare l'anteprima della clip

Per visualizzare l'anteprima della clip, effettua una chiamata GET a previewUrl utilizzando il token di accesso OAuth nell'intestazione HTTP Authorization:

Anteprima

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

Errori

Per l'elenco completo dei codici di errore dell'API, consulta il riferimento ai codici di errore dell'API.