CameraClipPreview-Schema

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

sdm.devices.traits.CameraClipPreview

Dieses Attribut gehört zu allen Geräten, die den Download einer Clipvorschau unterstützen.

Felder

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

Befehle

Für dieses Attribut sind keine Befehle verfügbar.

Ereignisse

ClipPreview

Ein Videoclip ist zur Vorschau verfügbar.

Eine Clipvorschau ist eine Videodatei mit 10 Frames im MP4-Format. Du kannst die MP4-Videodatei anzeigen oder sie in ein anderes Format transcodieren (z. B. ein animiertes GIF), um eine vollständige Sequenz mit 10 Frames zu zeigen. Bei der Auswahl einer Methode für die Clipvorschau sollten die Geräteclientfunktionen berücksichtigt werden.

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

Typ	Element	Beschreibung
Ereignis	Bewegungsereignis des Attributs CameraMotion	Die Kamera hat eine Bewegung erkannt.
Ereignis	Personenereignis des Attributs CameraPerson	Die Kamera hat eine Person erkannt.
Ereignis	Glocke Ereignis des Attributs DoorbellChime	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" : "8eebac0c-5280-4977-bea5-590409924ae0",
  "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"
  ]
}

Felder für das ClipPreview-Ereignis

Feld	Beschreibung	Datentyp
eventSessionId	Eine ID für Ereignisse, die im Rahmen einer einzelnen Sitzung zusammengehöriger Ereignisse auftreten. Kann zum Zusammenfassen von Ereignissen verwendet werden.	string Beispiel: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...“
previewUrl	Die URL, unter der du dir eine Vorschau des Videoclips ansehen kannst. Der Standard-Video-Codec ist H264.	string Beispiel: „https://previewUrl/...“

Felder für die Ereignisnutzlast

Feld	Beschreibung	Datentyp
eventId	Die eindeutige ID für das Ereignis.	string Beispiel: „8eebac0c-5280-4977-bea5-590409924ae0“
timestamp	Die Zeit, in der das Ereignis aufgetreten ist.	string Beispiel: „2019-01-01T00:00:01Z“
resourceUpdate	Ein Objekt mit Details zur Ressourcenaktualisierung.	object
userId	Eine eindeutige, verschleierte ID, die den Nutzer darstellt.	string Beispiel: „AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi“
resourceGroup	Ein Objekt, das Ressourcen angibt, für die ähnliche Aktualisierungen wie für dieses Ereignis gelten 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 findest du unter Ereignisse.

Vorschau des Clips ansehen

Wenn du dir eine Vorschau des Clips ansehen möchtest, rufe die previewUrl mit einer GET-Anfrage auf. Verwende 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.