CameraPerson-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 zur Personenerkennung unterstützen.

Felder

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

Befehle

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

Ereignisse

Person

Aktualisierbar 

Eine Person wurde von der Kamera erkannt.

Dieses Ereignis unterstützt aktualisierbare Benachrichtigungen. Bestehende App-Benachrichtigungen, die aus diesem Ereignis erstellt wurden, können mit dem Inhalt eines nachfolgenden Ereignisses mit demselben eventThreadId aktualisiert werden.

Person erkannt

Nutzlast

{
  "eventId" : "5ff7c81d-541d-45f7-9fb7-b59acf7088f5",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "cLwcdKVZql7R2OO_5N_AHrDa4G...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Felder für Personenereignisse

Feld Beschreibung Datentyp
eventSessionId Nest Doorbell (mit Akku) Nest Doorbell (mit Kabel) Eine ID für Ereignisse, die im Rahmen einer einzelnen Sitzung mit zugehörigen Ereignissen auftreten. Kann zum Konsolidieren von Ereignissen verwendet werden.

Verwenden Sie es, um dieses Ereignis mit dem zugehörigen ClipPreview-Ereignis des CameraClipPreview-Traits zu verknüpfen.

 string
Beispiel: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...“
eventId Nest Cam (alt) Nest Hub Max Nest Doorbell (alt) Eine ID, die dem Ereignis zugeordnet ist.

Verwenden Sie ihn mit dem GenerateImage-Befehl, um das Kamerabild herunterzuladen, das sich auf dieses Ereignis bezieht.

 string
Beispiel: „cLwcdKVZql7R2OO_5N_AHrDa4G...“

Felder der Ereignisnutzlast

Feld Beschreibung Datentyp
eventId Die eindeutige Kennung für das Ereignis. string
Beispiel: „5ff7c81d-541d-45f7-9fb7-b59acf7088f5“
timestamp Die Zeit, zu der das Ereignis aufgetreten ist. string
Beispiel: „2019-01-01T00:00:01Z“
resourceUpdate Ein Objekt mit Details zur Ressourcenaktualisierung. object
userId Eine eindeutige, verschleierte Kennung, die den Nutzer darstellt. string
Beispiel: „AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi“
eventThreadId Aktualisierbar 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 möglicherweise ähnliche Aktualisierungen wie dieses Ereignis haben. Die Ressource des Ereignisses selbst (aus dem resourceUpdate-Objekt) ist immer in diesem Objekt vorhanden. object

Weitere Informationen zu den verschiedenen Arten von Ereignissen und ihrer Funktionsweise finden Sie unter Ereignisse.

Fehler

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

Fehlermeldung RPC Fehlerbehebung
Das Kamerabild kann nicht mehr heruntergeladen werden. DEADLINE_EXCEEDED Veranstaltungsbilder laufen 30 Sekunden nach der Veröffentlichung der Veranstaltung ab. Laden Sie das Bild vor Ablauf des Gültigkeitszeitraums 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 finden Sie in der API-Fehlercode-Referenz.