CameraClipPreview-Schema

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

sdm.devices.traits.CameraClipPreview

Diese Eigenschaft gilt für alle Geräte, auf denen der Download einer Clipvorschau unterstützt wird.

Felder

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

Befehle

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

Ereignisse

ClipPreview

Es ist ein Videoclip als Vorschau verfügbar.

Eine Clipvorschau ist eine Videodatei mit 10 Frames im MP4-Format. Sie können die MP4-Videodatei anzeigen oder in ein anderes Format (z. B. ein animiertes GIF) transkodieren, um eine vollständige Sequenz von 10 Frames zu zeigen. Bei der Auswahl einer Methode für die Videovorschau sollten die Funktionen des Geräteclients berücksichtigt werden.

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

Typ Element Beschreibung
Ereignis Bewegung-Ereignis des Attributs „CameraMotion“ Die Kamera hat eine Bewegung erkannt.
Ereignis Person-Ereignis der Eigenschaft „CameraPerson“ Die Kamera hat eine Person erkannt.
Ereignis Ereignis Glocke des Attributs „DoorbellChime“ Die Türklingel wurde betätigt.
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" : "58abaf2e-fa2e-4fa6-8911-3ae521aeac28",
  "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

Feld Beschreibung Datentyp
eventSessionId Eine ID, die Ereignissen zugewiesen wird, die im Rahmen einer einzelnen Sitzung ähnlicher Ereignisse auftreten. Kann zum Zusammenführen von Ereignissen verwendet werden. string
Beispiel: „CjY5Y3VKaTZwR3o4Y19YbTVfMF…“
previewUrl Die URL, unter der eine Vorschau des Videoclips angezeigt wird. Der Standard-Video-Codec ist H264. string
Beispiel: „https://previewUrl/…“

Felder für die Ereignisnutzlast

Feld Beschreibung Datentyp
eventId Die eindeutige Kennung für das Ereignis. string
Beispiel: „58abaf2e-fa2e-4fa6-8911-3ae521aeac28“
timestamp Die Zeit, zu der das Ereignis aufgetreten ist. string
Beispiel: „2019-01-01T00:00:01Z“
resourceUpdate Ein Objekt mit Informationen zur Ressourcenaktualisierung. object
userId Eine eindeutige, verschleierte Kennung, 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 in diesem Objekt immer vorhanden. object

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

Clip in der Vorschau ansehen

Rufe zum Ansehen einer Videovorschau die previewUrl mit dem OAuth-Zugriffstoken im HTTP-Autorisierungsheader auf:

Vorschau

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

Fehler

Eine vollständige Liste der API-Fehlercodes findest du in der API-Fehlercode-Referenz.