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 sie in ein anderes Format (z. B. ein animiertes GIF) transcodieren, um eine vollständige Sequenz mit 10 Frames 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 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.
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" : "00b846e7-c79d-4a8f-a66b-cff468300323",
  "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: „00b846e7-c79d-4a8f-a66b-cff468300323“
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.