CameraClipPreview-Schema
Nest Doorbell (mit Akku)
sdm.devices.traits.CameraClipPreview
Diese Eigenschaft gehört zu jedem Gerät, das den Download einer Clipvorschau unterstützt.
Felder
Für diese Eigenschaft sind keine Felder verfügbar.
Befehle
Für diese Eigenschaft sind keine Befehle verfügbar.
Ereignisse
ClipPreview
Für die Vorschau ist ein Videoclip verfügbar.
Eine Clipvorschau ist eine 10-Frame-Videodatei im MP4-Format. Du kannst die MP4-Videodatei anzeigen oder sie in ein anderes Format wie ein animiertes GIF transcodieren, um eine vollständige Sequenz von zehn Frames zu zeigen. Bei der Auswahl einer Methode für die Clipvorschau sollten die Clientfunktionen auf dem Gerät berücksichtigt werden.
Dieses Ereignis wird für die folgenden Ereignisse unterstützt:
Typ | Element | Beschreibung |
---|---|---|
Ereignis | Ereignis Motion des Attributs „CameraMotion“ | Die Kamera hat Bewegung erkannt. |
Ereignis | Person-Ereignis der Eigenschaft KameraPerson | Die Kamera hat eine Person erkannt. |
Ereignis | Glocken-Ereignis der Eigenschaft „Türklingel“ | Die Türklingel wurde gedrückt. |
eventSessionId
, um dieses Ereignis und die zugehörige previewUrl
mit einem oder mehreren unterstützten Ereignissen zu verknüpfen.
ClipPreview-Ereignis
Nutzlast
{ "eventId" : "3e97e0c3-abe9-4fbe-9321-0f41582fe7af",
"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 |
ID für Ereignisse, die im Rahmen einer einzelnen Sitzung von verwandte Ereignisse. Kann zur Konsolidierung von Ereignissen verwendet werden. | string Beispiel: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...“ |
previewUrl |
Die URL, unter der eine Vorschau des Videoclips angezeigt werden soll. Der Standard-Video-Codec ist H264. | string Beispiel: „https://previewUrl/...“ |
Ereignisnutzlastfelder
Feld | Beschreibung | Datentyp |
---|---|---|
eventId |
Die eindeutige Kennung des Ereignisses. | string Beispiel: „3e97e0c3-abe9-4fbe-9321-0f41582fe7af“ |
timestamp |
Die Uhrzeit, zu der das Ereignis aufgetreten ist. | string Beispiel: „2019-01-01T00:00:01Z“ |
resourceUpdate |
Ein Objekt, das Details zur Ressourcenaktualisierung enthält. | object |
userId |
Eine eindeutige, verschleierte Kennung, die den Nutzer repräsentiert. | string Beispiel: „AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi“ |
resourceGroup |
Ein Objekt, das Ressourcen angibt, die ähnliche Aktualisierungen für dieses Ereignis haben könnten. Die Ressource des Ereignisses selbst (aus dem resourceUpdate -Objekt) ist immer in diesem Objekt vorhanden. |
object |
Unter Ereignisse finden Sie weitere Informationen zu den verschiedenen Ereignistypen und ihre Funktionsweise.
Vorschau des Clips ansehen
Wenn du dir eine Vorschau des Clips ansehen möchtest, starte einen GET-Aufruf an previewUrl
unter Verwendung des OAuth-Zugriffstokens im HTTP-Autorisierungsheader:
Vorschau
curl -H 'Authorization: Bearer access-token' \
https://previewUrl/...
Fehler
In der API-Fehlercode-Referenz können Sie nachlesen, die vollständige Liste der API-Fehlercodes.