CameraClipPreview-Schema

Nest Doorbell (mit Akku) Nest Doorbell (mit Kabel) 

sdm.devices.traits.CameraClipPreview

Diese Eigenschaft gehört zu jedem Gerät, das den Download einer Clipvorschau unterstützt.

Felder

Für diese Eigenschaft sind keine Felder verfügbar.

Befehle

Für diese Eigenschaft sind keine Befehle verfügbar.

Veranstaltungen

ClipPreview

Für die Vorschau ist ein Videoclip verfügbar.

Eine Clipvorschau ist eine 10-Frame-Videodatei im MP4-Format. Du kannst die MP4-Videodatei anzeigen oder sie in ein anderes Format wie ein animiertes GIF transcodieren, um eine vollständige Sequenz von zehn Frames zu zeigen. Bei der Auswahl einer Methode für die Clipvorschau sollten die Clientfunktionen auf dem Gerät berücksichtigt werden.

Dieses Ereignis wird für die folgenden Ereignisse unterstützt:

Typ Element Beschreibung
Veranstaltung Ereignis Motion des Attributs „CameraMotion“ Die Kamera hat Bewegung erkannt.
Veranstaltung Person-Ereignis der Eigenschaft KameraPerson Die Kamera hat eine Person erkannt.
Veranstaltung Glocken-Ereignis der Eigenschaft „Türklingel“ Die Türklingel wurde gedrückt.
Verwende eventSessionId, um dieses Ereignis und die zugehörige previewUrl mit einem oder mehreren unterstützten Ereignissen zu verknüpfen.

ClipPreview-Ereignis

Nutzlast

{
  "eventId" : "f17a224f-d0b0-4123-9416-a513e449a335",
  "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"
  ]
}

ClipPreview-Ereignisfelder

Field Beschreibung Datentyp
eventSessionId ID, die Ereignissen zugewiesen wird, die als Teil einer einzelnen Sitzung verwandter Ereignisse auftreten. Kann zur Konsolidierung von Ereignissen verwendet werden. string
Beispiel: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...“
previewUrl Die URL, unter der eine Vorschau des Videoclips angezeigt werden soll. Der Standard-Video-Codec ist H264. string
Beispiel: „https://previewUrl/...“

Ereignisnutzlastfelder

Field Beschreibung Datentyp
eventId Die eindeutige Kennung des Ereignisses. string
Beispiel: „f17a224f-d0b0-4123-9416-a513e449a335“
timestamp Die Uhrzeit, zu der das Ereignis aufgetreten ist. string
Beispiel: „2019-01-01T00:00:01Z“
resourceUpdate Ein Objekt, das Details zur Ressourcenaktualisierung enthält. object
userId Eine eindeutige, verschleierte Kennung, die den Nutzer repräsentiert. string
Beispiel: „AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi“
resourceGroup Ein Objekt, das Ressourcen angibt, die ähnliche Aktualisierungen für dieses Ereignis haben könnten. Die Ressource des Ereignisses selbst (aus dem resourceUpdate-Objekt) ist immer in diesem Objekt vorhanden. object

Weitere Informationen zu den verschiedenen Ereignistypen und ihrer Funktionsweise finden Sie unter Ereignisse.

Vorschau des Clips ansehen

Wenn du dir eine Vorschau des Clips ansehen möchtest, starte einen GET-Aufruf an previewUrl unter Verwendung des OAuth-Zugriffstokens im HTTP-Autorisierungsheader:

Vorschau

curl -H 'Authorization: Bearer access-token' \
  https://previewUrl/...

Fehler

Eine vollständige Liste der API-Fehlercodes finden Sie in der API-Fehlercode-Referenz.