CameraMotion-Schema

sdm.devices.traits.CameraMotion

Dieser Trait gehört zu jedem Gerät, das Bewegungserkennungsereignisse unterstützt.

Felder

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

Befehle

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

Ereignisse

Bewegung

Aktualizierbar 

Die Kamera hat eine Bewegung erkannt.

Dieses Ereignis unterstützt aktualisierbare Benachrichtigungen. Vorhandene App-Benachrichtigungen, die durch diesen Termin erstellt wurden, können mit dem Inhalt eines nachfolgenden Termins mit derselben eventThreadId aktualisiert werden.

Bewegungsereignis

Nutzlast

{
  "eventId" : "a79dbc7d-5ada-4328-abdd-af5fee0ebe1c",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.CameraMotion.Motion" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "4yBL77d_NvC-o_wtepejBbtCgw...", } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
"eventThreadState" : "STARTED",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }

Bewegungsereignisfelder

Feld Beschreibung Datentyp
eventSessionId Nest Doorbell (mit Akku) Nest Doorbell (mit Kabel) Eine ID für Ereignisse, die während einer einzigen Sitzung verwandte Ereignisse. Kann zum Konsolidieren von Ereignissen verwendet werden.

Damit können Sie dieses Ereignis mit dem zugehörigen Ereignis ClipPreview des Attributs „CameraClipPreview“ verknüpfen.

string
Beispiel: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...“
eventId Nest Cam (alte Version) Nest Hub Max Nest Doorbell (alte Version) Eine mit dem Ereignis verknüpfte ID.

Verwenden Sie es zusammen mit dem Befehl GenerateImage (Generieren), um das Kamerabild für dieses Ereignis herunterzuladen.

string
Beispiel: „4yBL77d_NvC-o_wtepejBbtCgw...“

Ereignisnutzlastfelder

Feld Beschreibung Datentyp
eventId Die eindeutige Kennung für das Ereignis. string
Beispiel: „a79dbc7d-5ada-4328-abdd-af5fee0ebe1c“
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“
eventThreadId Aktualisierbar Die eindeutige Kennung für den Ereignisthread string
Beispiel: „d67cd3f7-86a7-425e-8bb3-462f92ec9f59“
eventThreadState Aktualisierbar Der Status des Ereignisthreads string
Werte: „STARTED“, „UPDATED“, „ENDED“
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.

Fehler

Die folgenden Fehlercodes können in Bezug auf dieses Merkmal zurückgegeben werden:

Fehlermeldung RPC Fehlerbehebung
Kamerabild kann nicht mehr heruntergeladen werden. DEADLINE_EXCEEDED Ereignisbilder laufen 30 Sekunden nach der Veröffentlichung des Ereignisses ab. Laden Sie das Bild vor Ablauf herunter.
Ereignis-ID gehört nicht zur Kamera. FAILED_PRECONDITION Verwende die korrekte eventID, die vom Kameraereignis zurückgegeben wurde.

In der API-Fehlercode-Referenz können Sie nachlesen, die vollständige Liste der API-Fehlercodes.