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

Nie ma żadnych pól dostępnych dla tej cechy.

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" : "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"
  ]
}

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: „mGffueV-vNuJR_SY-ZeH1_LofV...”.

Pola ładunku zdarzeń

Pole Opis Typ danych
eventId Unikalny identyfikator zdarzenia. string
Przykład: „b27bcd8c-5617-44e4-9409-f4b3510e4550”
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 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.