Esquema CameraClipPreview
Nest Doorbell (com bateria)
sdm.devices.traits.CameraClipPreview
Essa característica pertence a qualquer dispositivo compatível com o download de uma prévia de clipe.
Campos
Não há campos disponíveis para essa característica.
Comandos
Não há comandos disponíveis para essa característica.
Eventos
ClipPreview
Um videoclipe está disponível para visualização.
A visualização do clipe é um arquivo de vídeo de 10 frames em formato mp4. Você pode optar por 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 precisam ser considerados ao selecionar um método de visualização de clipes.
Este evento é compatível com os seguintes eventos:
Tipo | Elemento | Descrição |
---|---|---|
Evento | Evento Motion do traço 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 pressionada. |
eventSessionId
para associar este evento e a previewUrl
relacionada a um ou mais eventos compatíveis.
Evento ClipPreview
Payload
{ "eventId" : "3e97e0c3-abe9-4fbe-9321-0f41582fe7af",
"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 do evento ClipPreview
Campo | Descrição | Tipo de dados |
---|---|---|
eventSessionId |
Um ID dado 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 no qual visualizar o videoclipe. 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: "3e97e0c3-abe9-4fbe-9321-0f41582fe7af" |
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 próprio evento (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.
Conferir o clipe
Para visualizar a transferência, 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 do código de erro da API para a lista completa de códigos de erro da API.