Esquema CameraClipPreview

Nest Doorbell (con batería) Nest Doorbell (con cable)

sdm.devices.traits.CameraClipPreview

Este trait pertenece a cualquier dispositivo que admita la descarga de una vista previa del clip.

Campos

No hay campos disponibles para esta característica.

Comandos

No hay comandos disponibles para esta trait.

Eventos

ClipPreview

Hay un clip de video disponible para vista previa.

Una vista previa del clip es un archivo de video de 10 fotogramas en formato mp4. Puedes 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 tener en cuenta las capacidades del cliente del dispositivo cuando se selecciona un método de vista previa del clip.

Este evento es compatible con los siguientes eventos:

Tipo	Elemento	Descripción
Evento	Evento Motion del trait CameraMotion	La cámara detectó movimiento.
Evento	Evento Person del trait CameraPerson	La cámara detectó a una persona.
Evento	Evento Chime del trait DoorbellChime	Se presionó el timbre.

Usa el eventSessionId para asociar este evento y el previewUrl relacionado con uno o más eventos admitidos.

Evento ClipPreview

Carga útil

{
  "eventId" : "572604ad-2277-41bb-907d-7887435467c2",
  "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	Descripción	Tipo de datos
`eventSessionId`	Es un ID que se asigna a los eventos que ocurren como parte de una sola sesión de eventos relacionados. Se puede usar para consolidar eventos.	`string` Ejemplo: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
`previewUrl`	Es la URL en la que se puede obtener 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: "572604ad-2277-41bb-907d-7887435467c2"
`timestamp`	Es la hora en la que ocurrió el evento.	`string` Ejemplo: "2019-01-01T00:00:01Z"
`resourceUpdate`	Es 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`	Es un objeto que indica los recursos que podrían tener actualizaciones similares a este evento. El recurso del evento en sí (del objeto `resourceUpdate`) siempre estará presente en este objeto.	`object`

Consulta Eventos para obtener más información sobre los diferentes tipos y cómo funcionan.

Obtén una vista previa del clip

Para obtener una vista previa del clip, realiza una llamada GET a previewUrl con el token de acceso de 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 la API para ver la lista completa de códigos de error.