Esquema CameraClipPreview

Nest Doorbell (battery) Nest Doorbell (wired)

sdm.devices.traits.CameraClipPreview

Esse trait pertence a qualquer dispositivo que ofereça suporte ao download de uma visualização de clipe.

Campos

Não há campos disponíveis para esse trait.

Comandos

Não há comandos disponíveis para esse trait.

Eventos

ClipPreview

Um clipe de vídeo está disponível para visualização.

Uma visualização de clipe é um arquivo de vídeo de 10 frames no formato MP4. Você pode mostrar o arquivo de vídeo MP4 ou transcodificá-lo para outro formato (por exemplo, um GIF animado) para mostrar uma sequência completa de 10 frames. As funcionalidades do cliente do dispositivo precisam ser consideradas ao selecionar um método de visualização de clipe.

Esse evento é compatível com os seguintes eventos:

Tipo	Elemento	Descrição
Evento	Evento de movimento do trait CameraMotion	O movimento foi detectado pela câmera.
Evento	Evento de pessoa do trait CameraPerson	Uma pessoa foi detectada pela câmera.
Evento	Evento de toque do trait DoorbellChime	A campainha foi pressionada.

Use o eventSessionId para associar esse evento e o previewUrl relacionado a um ou mais eventos compatíveis.

Evento ClipPreview

Payload

{
  "eventId" : "81791446-53bd-4c44-9c34-959e5be0228d",
  "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"
  ]
}

Campos de evento ClipPreview

Campo	Descrição	Tipo de dados
`eventSessionId`	Um ID atribuído a eventos que ocorrem como parte de uma única sessão de eventos relacionados. Pode ser usado para consolidar eventos.	`string` Exemplo: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
`previewUrl`	O URL em que o clipe de vídeo será visualizado. O codec de vídeo padrão é H264.	`string` Exemplo: "https://`previewUrl`/..."

Campos de payload de eventos

Campo	Descrição	Tipo de dados
`eventId`	O identificador exclusivo do evento.	`string` Exemplo: "81791446-53bd-4c44-9c34-959e5be0228d"
`timestamp`	A hora em que o evento ocorreu.	`string` Exemplo: "2019-01-01T00:00:01Z"
`resourceUpdate`	Um objeto que detalha informações sobre a atualização de recursos.	`object`
`userId`	Um identificador exclusivo e ofuscado que representa o usuário.	`string` Exemplo: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
`resourceGroup`	Um objeto que indica recursos que podem ter atualizações semelhantes a esse evento. O recurso do evento em si (do objeto `resourceUpdate`) sempre estará presente nesse objeto.	`object`

Consulte Eventos para mais informações sobre os diferentes tipos de eventos e como eles funcionam.

Visualizar o clipe

Para visualizar o clipe, faça uma chamada GET para o previewUrl usando o token de acesso OAuth no cabeçalho de autorização HTTP:

Visualizar

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

Erros

Consulte a Referência de códigos de erro da API para conferir a lista completa de códigos de erro da API.