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 dieses Merkmal sind keine Felder verfügbar.
Befehle
Für diese Eigenschaft sind keine Befehle verfügbar.
Ereignisse
ClipPreview
Es ist ein Videoclip als Vorschau verfügbar.
Eine Clipvorschau ist eine 10-Frame-Videodatei 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 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 | Bewegung-Ereignis des Attributs „CameraMotion“ | Die Kamera hat eine Bewegung erkannt. |
Ereignis | Person-Ereignis der Eigenschaft KameraPerson | Die Kamera hat eine Person erkannt. |
Ereignis | Ereignis Glocke des Attributs „DoorbellChime“ | 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" : "03a66aac-1eb5-4792-aaca-51beb74fada7",
"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 des Ereignisses. | string Beispiel: „03a66aac-1eb5-4792-aaca-51beb74fada7“ |
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 immer in diesem Objekt vorhanden. |
object |
Weitere Informationen zu den verschiedenen Ereignistypen und ihrer Funktionsweise finden Sie unter Ereignisse.
Clip in der Vorschau 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
Eine vollständige Liste der API-Fehlercodes findest du in der API-Fehlercode-Referenz.