Kamerateam-Schema

Nest Cam (alt) Nest Cam (Outdoor oder Indoor, mit Akku) Nest Cam mit Flutlicht Nest Cam (Indoor, mit Kabel) Nest Hub Max Nest Doorbell (alt) Nest Doorbell (mit Akku) Nest Doorbell (mit Kabel) 

sdm.devices.traits.CameraPerson

Dieses Attribut gehört zu allen Geräten, die Ereignisse der Personenerkennung unterstützen.

Felder

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

Befehle

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

Ereignisse

Person

Aktualizierbar 

Die Kamera hat eine Person erkannt.

Dieses Ereignis unterstützt aktualisierbare Benachrichtigungen. Vorhandene App-Benachrichtigungen, die auf Grundlage dieses Ereignisses erstellt wurden, können mit dem Inhalt eines nachfolgenden Ereignisses mit derselben eventThreadId aktualisiert werden.

Person erkannt

Nutzlast

{
  "eventId" : "b27bcd8c-5617-44e4-9409-f4b3510e4550",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "mGffueV-vNuJR_SY-ZeH1_LofV...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Felder für Ereignisse vom Typ „Person erkannt“

Feld Beschreibung Datentyp
eventSessionId Nest Doorbell (mit Akku) Nest Doorbell (mit Kabel) Eine ID, die Ereignissen zugewiesen wird, die im Rahmen einer einzelnen Sitzung ähnlicher Ereignisse auftreten. Kann zum Zusammenführen von Ereignissen verwendet werden.

Verwenden Sie es, um dieses Ereignis mit dem zugehörigen Ereignis ClipPreview der Eigenschaft „CameraClipPreview“ zu verknüpfen.

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

Verwenden Sie ihn mit dem Befehl „GenerateImage“, um das mit diesem Ereignis verknüpfte Kamerabild herunterzuladen.

 string
Beispiel: „mGffueV-vNuJR_SY-ZeH1_LofV…“

Felder für die Ereignisnutzlast

Feld Beschreibung Datentyp
eventId Die eindeutige Kennung für das Ereignis. string
Beispiel: „b27bcd8c-5617-44e4-9409-f4b3510e4550“
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“
eventThreadId Updateable Die eindeutige Kennung für den Ereignis-Thread. string
Beispiel: „d67cd3f7-86a7-425e-8bb3-462f92ec9f59“
eventThreadState Updateable 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 in diesem Objekt immer vorhanden. object

Weitere Informationen zu den verschiedenen Ereignistypen und ihrer Funktionsweise finden Sie unter Ereignisse.

Fehler

In Bezug auf dieses Attribut können die folgenden Fehlercodes 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. Laden Sie das Bild vor Ablauf herunter.
Die Ereignis-ID gehört nicht zur Kamera. FAILED_PRECONDITION Verwenden Sie die richtige eventID, die vom Kameraereignis zurückgegeben wird.

Eine vollständige Liste der API-Fehlercodes findest du in der API-Fehlercode-Referenz.