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 Frames im MP4-Format. Sie können die MP4-Videodatei anzeigen oder 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 Clip-Vorschau 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	Klingelereignis 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" : "450d6756-e37b-434c-8b9e-202fdd5b0fc1",
  "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 der ClipPreview-Ereignisnutzlast

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 Sie sich den Videoclip ansehen können. Der Standard-Video-Codec ist H264.	`string` Beispiel: „https://`previewUrl`/...“

Felder der Ereignisnutzlast

Feld	Beschreibung	Datentyp
`eventId`	Die eindeutige ID für das Ereignis.	`string` Beispiel: „450d6756-e37b-434c-8b9e-202fdd5b0fc1“
`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 finden Sie unter Ereignisse.

Vorschau des Clips ansehen

Um sich den Clip anzusehen, führen Sie einen GET-Aufruf an den previewUrl aus und verwenden Sie im HTTP-Autorisierungsheader das OAuth-Zugriffstoken:

Vorschau

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

Fehler

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