Schemat CameraPerson

Nest Cam (starsza wersja) Nest Cam (zewnętrzna lub wewnętrzna, zasilana baterią) Nest Cam z reflektorem Nest Cam (wewnętrzna, zasilana z sieci) Nest Hub Max Nest Doorbell (starsza wersja) Nest Doorbell (na baterie) 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 żadnych dostępnych pól.

Polecenia

W przypadku tej cechy nie ma dostępnych poleceń.

Wydarzenia

Osoba

Możliwość aktualizacji 

Kamera wykryła osobę.

To zdarzenie obsługuje powiadomienia z możliwością aktualizacji. Istniejące powiadomienia aplikacji utworzone na podstawie tego zdarzenia można zaktualizować, używając treści kolejnego zdarzenia z tym samym eventThreadId.

Zdarzenie związane z osobą

Ładunek

{
  "eventId" : "0b034990-aec9-465f-89dd-a0fdb392f0b8",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.CameraPerson.Person" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "-yPAPDeLpNTUTSNzmrnR6BrDCJ...", } } } "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 Urządzenie Nest Doorbell (na baterie) Urządzenie Nest Doorbell (zasilane z sieci) Identyfikator nadawany zdarzeniom występującym w ramach pojedynczej sesji powiązanych zdarzeń. Może służyć do konsolidowania zdarzeń.

Użyj go, aby powiązać to zdarzenie z powiązanym zdarzeniem ClipPreview atrybutu 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 powiązany z tym zdarzeniem.

string
Przykład: „-yPAPDeLpNTUTSNzmrnR6BrDCJ...”.

Pola ładunku zdarzeń

Pole Opis Typ danych
eventId Unikalny identyfikator zdarzenia. string
Przykład: „0b034990-aec9-465f-89dd-a0fdb392f0b8”.
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, zanonimizowany 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 zdarzenia. string
Wartości: „STARTED” (rozpoczęto), „UPDATED” (zaktualizowano) i „ENDED” (zakończono).
resourceGroup Obiekt wskazujący zasoby, które mogą mieć podobne aktualizacje do tego zdarzenia. Zasoby samego zdarzenia (z obiektu resourceUpdate) będą zawsze obecne 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 tą cechą mogą zostać zwrócone te kody błędów:

Komunikat o błędzie RPC Rozwiązywanie problemów
Obraz z aparatu 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łowej wartości eventID zwróconej przez zdarzenie związane z kamerą.

Pełną listę kodów błędów interfejsu API znajdziesz w przewodniku po kodach błędów interfejsu API.