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 Clip-Vorschau 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 Clip-Vorschau ist eine Videodatei mit 10 Bildern im MP4-Format. Sie können die MP4-Videodatei anzeigen oder sie in ein anderes Format transcodieren (z. B. ein animiertes GIF), um eine vollständige Sequenz mit 10 Bildern zu zeigen. Bei der Auswahl einer Methode für die Clip-Vorschau sollten die Funktionen des Geräteclients berücksichtigt werden.

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

Typ Element Beschreibung
Ereignis Motion-Ereignis des Attributs CameraMotion Die Kamera hat eine Bewegung erkannt.
Ereignis Person-Ereignis des Attributs CameraPerson Die Kamera hat eine Person erkannt.
Ereignis Chime-Ereignis des Attributs DoorbellChime Die Türklingel wurde gedrückt.
Verwenden Sie eventSessionId, um dieses Ereignis und die zugehörige previewUrl mit einem oder mehreren unterstützten Ereignissen zu verknüpfen.

ClipPreview-Ereignis

Nutzlast

{
  "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"
  ]
}

Felder für das ClipPreview-Ereignis

Feld Beschreibung Datentyp
eventSessionId Eine ID für Ereignisse, die im Rahmen einer einzelnen Sitzung verwandter Ereignisse auftreten. Kann zum Zusammenfassen von Ereignissen verwendet werden. string
Beispiel: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...“
previewUrl Die URL, unter der Sie sich eine Vorschau des Videoclips ansehen können. 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: „572604ad-2277-41bb-907d-7887435467c2“
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, 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

Wenn Sie sich eine Vorschau des Clips ansehen möchten, rufen Sie die previewUrl mit einem GET-Aufruf auf. 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.