Esquema de CameraClipPreview

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

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 este rasgo.

Eventos

ClipPreview

Hay un clip de video disponible para la vista previa.

La vista previa de un clip es un archivo de video de 10 fotogramas en formato mp4. Puedes optar por mostrar el archivo de video mp4 o transcodificarlo a otro formato (por ejemplo, un GIF animado) para mostrar una secuencia completa de 10 fotogramas. Las capacidades del cliente del dispositivo se deben tener en cuenta cuando se selecciona un método de vista previa de clips.

Este evento se admite para los siguientes eventos:

Tipo Elemento Descripción
Evento Evento Motion del rasgo CameraMotion La cámara detectó movimiento.
Evento Evento Person del rasgo CameraPerson La cámara detectó a una persona.
Evento Evento Chime del rasgo DoorbellChime Se presionó el timbre.
Usa eventSessionId para asociar este evento y el previewUrl relacionado con uno o más eventos admitidos.

Evento ClipPreview

Carga útil

{
  "eventId" : "1bb063ae-09d3-4fb3-b7a3-6795e5e18d47",
  "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 del 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: "1bb063ae-09d3-4fb3-b7a3-6795e5e18d47"
timestamp Es la fecha y hora en 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 las de 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 de eventos y cómo funcionan.

Obtener 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 de la API.