Esquema CameraClipPreview

Nest Doorbell (com bateria) Nest Doorbell (com fio) 

sdm.devices.traits.CameraClipPreview

Esse atributo pertence a qualquer dispositivo que permita o download de uma prévia 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.

A prévia de um 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. Os recursos do cliente do dispositivo devem ser considerados ao selecionar um método de prévia de clipe.

Este evento é compatível com os seguintes eventos:

Tipo Elemento Descrição
Evento Evento Motion da característica CameraMotion A câmera detectou movimento.
Evento Evento Person da característica CameraPerson Uma pessoa foi detectada pela câmera.
Evento Evento Chime da característica DoorbellChime A campainha foi tocada.
Use o eventSessionId para associar esse evento e o previewUrl relacionado a um ou mais eventos compatíveis.

Evento ClipPreview

Payload

{
  "eventId" : "6c648daa-5aa9-47b4-80f4-05a22ef953e2",
  "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 de 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 pode ser visualizado. O codec de vídeo padrão é H264. string
Exemplo: "https://previewUrl/..."

Campos de payload de evento

Campo Descrição Tipo de dados
eventId O identificador exclusivo do evento. string
Exemplo: "6c648daa-5aa9-47b4-80f4-05a22ef953e2"
timestamp O horário em que o evento ocorreu. string
Exemplo: "2019-01-01T00:00:01Z"
resourceUpdate Um objeto que detalha informações sobre a atualização do recurso. 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 este 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 do 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 do erro da API para ver a lista completa de códigos do erro da API.