CameraPerson-Schema

Nest Cam (alte Version) Nest Cam (Outdoor oder Indoor, mit Akku) Nest Cam mit Flutlicht Nest Cam (Indoor, mit Kabel) Nest Cam (Indoor, mit Kabel) Nest Cam (Indoor, mit Kabel)Nest Hub Nest Hub Nest Hub

sdm.devices.traits.CameraPerson

Diese Eigenschaft gehört zu jedem Gerät, das Personenentdeckungsereignisse unterstützt.

Felder

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

Befehle

Für diese Eigenschaft sind keine Befehle verfügbar.

Veranstaltungen

Personen

Aktualisierbar 

Die Kamera hat eine Person erkannt.

Für dieses Ereignis können Benachrichtigungen aktualisiert werden. Vorhandene App-Benachrichtigungen, die auf Grundlage dieses Ereignisses erstellt wurden, können mit dem Inhalt eines nachfolgenden Ereignisses mit demselben eventThreadId aktualisiert werden.

Personenereignis

Nutzlast

{
  "eventId" : "d582ccc6-0de9-4cf3-a9ed-cc3b39218c97",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "M7S78ZiC4dTyGf_fPHczuRv26r...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Felder für Personenereignisse

Field Beschreibung Datentyp
eventSessionId Nest Doorbell (mit Akku) Nest Doorbell (mit Kabel) Eine ID, die Ereignissen im Rahmen einer einzelnen Sitzung verwandter Ereignisse zugeordnet wird. Kann zur Konsolidierung von Ereignissen verwendet werden.

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

 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“, um das Kamerabild für dieses Ereignis herunterzuladen.

 string
Beispiel: „M7S78ZiC4dTyGf_fPHczuRv26r...“

Felder der Ereignisnutzlast

Field Beschreibung Datentyp
eventId Die eindeutige Kennung des Ereignisses. string
Beispiel: „d582ccc6-0de9-4cf3-a9ed-cc3b39218c97“
timestamp Der Zeitpunkt, zu dem das Ereignis aufgetreten ist. string
Beispiel: „2019-01-01T00:00:01Z“
resourceUpdate Ein Objekt, das Informationen zum Ressourcenupdate enthält. object
userId Eine eindeutige, verschleierte Kennung, die den Nutzer repräsentiert. string
Beispiel: „AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi“
eventThreadId Aktualisierbar Die eindeutige Kennung des Ereignis-Threads. string
Beispiel: „d67cd3f7-86a7-425e-8bb3-462f92ec9f59“
eventThreadState Aktualisierbar Der Status des Ereignis-Threads. string
Werte: „STARTED“, „UPDATED“, „ENDED“
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.

Fehler

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

Fehlermeldung RPC Fehlerbehebung
Das Kamerabild kann nicht mehr heruntergeladen werden. DEADLINE_EXCEEDED Ereignisbilder laufen 30 Sekunden nach der Veröffentlichung des Ereignisses ab. Achten Sie darauf, das Bild vor dem Ablaufdatum herunterzuladen.
Ereignis-ID gehört nicht zur Kamera. FAILED_PRECONDITION Verwenden Sie den korrekten eventID, der vom Kamera-Ereignis zurückgegeben wurde.

Eine vollständige Liste der API-Fehlercodes finden Sie in der API-Fehlercode-Referenz.