Esquema CameraClipPreview
Nest Doorbell (con batería)
sdm.devices.traits.CameraClipPreview
Esta característica pertenece a cualquier dispositivo que admita la descarga de una vista previa de un clip.
Campos
No hay campos disponibles para esta característica.
Comandos
No hay comandos disponibles para esta característica.
Eventos
ClipPreview
Hay un clip de video disponible para obtener una vista previa.
Una vista previa de clip es un archivo de video de 10 fotogramas en formato mp4. Puedes elegir mostrar el archivo de video mp4 o transcodificarlo a otro formato (por ejemplo, un GIF animado) para mostrar una secuencia completa de 10 fotogramas. Se deben considerar las capacidades del cliente del dispositivo cuando se selecciona un método de vista previa de clips.
Este evento es compatible con los siguientes eventos:
Tipo | Elemento | Descripción |
---|---|---|
Evento | Evento Motion de la característica CameraMotion | La cámara detectó movimiento. |
Evento | Evento Person del rasgo CameraPerson | La cámara detectó a una persona. |
Evento | Evento Timbre del trait DoorbellChime | Se presionó el timbre. |
eventSessionId
para asociar este evento y el previewUrl
relacionado con uno o más eventos compatibles.
Evento ClipPreview
Carga útil
{ "eventId" : "32818c67-a2c5-487e-a993-e91461c93c38",
"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 | Descripción | Tipo de datos |
---|---|---|
eventSessionId |
Un ID asignado a los eventos que ocurren como parte de una única sesión de eventos relacionados. Se puede usar para consolidar eventos. | string Ejemplo: “CjY5Y3VKaTZwR3o4Y19YbTVfMF...” |
previewUrl |
URL en la que se obtiene una vista previa del clip de video. El códec de video predeterminado es H264 | string Ejemplo: “https://previewUrl/...” |
Campos de carga útil del evento
Campo | Descripción | Tipo de datos |
---|---|---|
eventId |
Es el identificador único del evento. | string Ejemplo: “32818c67-a2c5-487e-a993-e91461c93c38” |
timestamp |
Indica la hora a la que ocurrió el evento. | string Ejemplo: “2019-01-01T00:00:01Z” |
resourceUpdate |
Un objeto que detalla información sobre la actualización del recurso. | object |
userId |
Es un identificador único y ofuscado que representa al usuario. | string Ejemplo: “AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi” |
resourceGroup |
Un objeto que indica recursos que pueden tener actualizaciones similares a este evento. El recurso del evento (del objeto resourceUpdate ) siempre estará presente en este objeto. |
object |
Consulta Eventos para obtener más información sobre los diferentes de eventos y cómo funcionan.
Obtén una vista previa del clip
Para obtener una vista previa del clip, realiza una llamada GET al previewUrl
con el token de acceso OAuth en el encabezado de autorización HTTP:
Vista previa
curl -H 'Authorization: Bearer access-token' \
https://previewUrl/...
Errores
Consulta la referencia de códigos de error de API para la lista completa de códigos de error de API.