Schemat CameraPerson

Nest Cam (starsza wersja) Nest Cam (zewnętrzna lub wewnętrzna, zasilana bateryjnie) Nest Cam z reflektorem Nest Cam (wewnętrzna, zasilana z sieci) Nest Hub Max Nest Doorbell (starsza wersja) Nest Doorbell (zasilany bateryjnie) Nest Doorbell (zasilany z sieci) 

sdm.devices.traits.CameraPerson

Ta cecha należy do każdego urządzenia, które obsługuje zdarzenia wykrywania osób.

Pola

W przypadku tej cechy nie ma dostępnych żadnych pól.

Polecenia

W przypadku tej cechy nie są dostępne żadne polecenia.

Wydarzenia

Osoba

Możliwość aktualizacji 

Kamera wykryła osobę.

To zdarzenie obsługuje powiadomienia, które można aktualizować. Istniejące powiadomienia z aplikacji utworzone na podstawie tego zdarzenia można aktualizować za pomocą treści kolejnego zdarzenia z tym samym eventThreadId.

Zdarzenie związane z osobą

Ładunek

{
  "eventId" : "2b16ac0a-6477-494e-b7e2-790ec1c46b85",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "1rMqbtBm0jjUaUhN0aVfqj02vU...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Pola zdarzenia związanego z osobą

Pole Opis Typ danych
eventSessionId Nest Doorbell (na baterie) Nest Doorbell (zasilany z sieci) Identyfikator przypisywany do zdarzeń występujących w ramach jednej sesji powiązanych zdarzeń. Może być używany do konsolidowania zdarzeń.

Użyj go, aby powiązać to zdarzenie z powiązanym zdarzeniem ClipPreview cechy CameraClipPreview.

 string
Przykład: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...”.
eventId Nest Cam (starsza wersja) Nest Hub Max Nest Doorbell (starsza wersja) Identyfikator powiązany z wydarzeniem.

Użyj go z poleceniem GenerateImage, aby pobrać obraz z kamery związany z tym zdarzeniem.

 string
Przykład: „1rMqbtBm0jjUaUhN0aVfqj02vU...”.

Pola ładunku zdarzenia

Pole Opis Typ danych
eventId Unikalny identyfikator zdarzenia. string
Przykład: „2b16ac0a-6477-494e-b7e2-790ec1c46b85”
timestamp Czas wystąpienia zdarzenia. string
Przykład: „2019-01-01T00:00:01Z”
resourceUpdate Obiekt zawierający szczegółowe informacje o aktualizacji zasobu. object
userId Unikalny, celowo zniekształcony identyfikator reprezentujący użytkownika. string
Przykład: „AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi”
eventThreadId Możliwość aktualizacji Unikalny identyfikator wątku zdarzenia. string
Przykład: „d67cd3f7-86a7-425e-8bb3-462f92ec9f59”
eventThreadState Możliwość aktualizacji Stan wątku wydarzenia. string
Wartości: „STARTED”, „UPDATED”, „ENDED”
resourceGroup Obiekt wskazujący zasoby, które mogą mieć podobne aktualizacje do tego zdarzenia. Zasób samego zdarzenia (z obiektu resourceUpdate) będzie zawsze obecny w tym obiekcie. object

Więcej informacji o różnych typach zdarzeń i ich działaniu znajdziesz w sekcji Zdarzenia.

Błędy

W związku z tym atrybutem mogą być zwracane te kody błędów:

Komunikat o błędzie RPC Rozwiązywanie problemów
Obraz z kamery nie jest już dostępny do pobrania. DEADLINE_EXCEEDED Obrazy wydarzeń wygasają 30 sekund po opublikowaniu wydarzenia. Pamiętaj, aby pobrać obraz przed wygaśnięciem.
Identyfikator zdarzenia nie należy do kamery. FAILED_PRECONDITION Użyj prawidłowego parametru eventID zwróconego przez zdarzenie kamery.

Pełną listę kodów błędów interfejsu API znajdziesz w dokumentacji kodów błędów interfejsu API.