KameraClipPreview-Schema

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

sdm.devices.traits.CameraClipPreview

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

Felder

Für dieses Trait sind keine Felder verfügbar.

Befehle

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

Veranstaltungen

ClipPreview

Ein Videoclip ist für die Vorschau verfügbar.

Eine Clipvorschau ist eine Videodatei mit 10 Frames im MP4-Format. Sie können die MP4-Videodatei entweder anzeigen lassen oder sie in ein anderes Format (z. B. ein animiertes GIF) transkodieren, um eine vollständige Abfolge von 10 Frames anzuzeigen. Bei der Auswahl der Clipvorschau sollten die Funktionen des Geräteclients berücksichtigt werden.

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

Typ Element Beschreibung
Veranstaltung Ereignis Bewegung des Traits „CameraMotion“ Die Kamera hat Bewegung erkannt.
Veranstaltung Ereignis Person der Eigenschaft „CameraPerson“ Die Kamera hat eine Person erkannt.
Veranstaltung Ereignis Glocke des Merkmals „Türklingeln“ Die Türklingel wurde betätigt.
Verwende eventSessionId, um dieses Ereignis und das zugehörige previewUrl mit einem oder mehreren unterstützten Ereignissen zu verknüpfen.

ClipPreview-Ereignis

Nutzlast

{
  "eventId" : "54e55063-25e6-44a5-9aa7-704405bb1c91",
  "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"
  ]
}

Ereignisfelder der ClipPreview

Field Beschreibung Datentyp
eventSessionId Eine ID, die Ereignissen zugewiesen wird, die im Rahmen einer einzelnen Sitzung verwandter Ereignisse auftreten. Kann zur Konsolidierung von Ereignissen verwendet werden. string
Beispiel: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...“
previewUrl Die URL, unter der die Vorschau des Videoclips aufgerufen werden kann. Der standardmäßige Video-Codec ist H264. string
Beispiel: „https://previewUrl/...“

Felder der Ereignisnutzlast

Field Beschreibung Datentyp
eventId Die eindeutige Kennung des Ereignisses. string
Beispiel: „54e55063-25e6-44a5-9aa7-704405bb1c91“
timestamp Der Zeitpunkt, zu dem das Ereignis aufgetreten ist. string
Beispiel: „2019-01-01T00:00:01Z“
resourceUpdate Ein Objekt, das Informationen zum Ressourcenupdate 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 wie 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

Um den Clip in der Vorschau anzusehen, führen Sie einen GET-Aufruf an previewUrl aus. Verwenden Sie dazu das OAuth-Zugriffstoken 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.