CameraPerson-Schema
Nest Cam (alte Version)
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
AktualisierbarDie 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) Damit verknüpfen Sie dieses Ereignis mit dem zugehörigen Ereignis ClipPreview des Traits „CameraClipPreview“. |
string Beispiel: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...“ |
eventId |
Nest Cam (alte Version) 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 |
string Beispiel: „d67cd3f7-86a7-425e-8bb3-462f92ec9f59“ |
eventThreadState |
Aktualisierbar |
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.