Schemat kamery CameraPerson

Nest Doll Doll (starsza wersja) Nest Cam (zewnętrzna lub wewnętrzna, na baterie) Nest Cam z reflektorem Nest HubNest Hub, przewodowe1}1}

sdm.devices.traits.CameraPerson

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

Pola

Brak dostępnych pól dla tej cechy.

Polecenia

Nie ma dostępnych poleceń dla tej cechy.

Wydarzenia

Osoba

Można zaktualizować 

Kamera wykryła osobę.

To wydarzenie obsługuje powiadomienia, które można zaktualizować. Istniejące powiadomienia w aplikacji utworzone na podstawie tego zdarzenia można zaktualizować przy użyciu treści kolejnego wydarzenia z tym samym atrybutem eventThreadId.

Zdarzenie dotyczące osoby

Ładunek

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

Pola dotyczące zdarzenia dotyczącego osoby

Pole Opis Typ danych
eventSessionId Nest Doorbell (na baterie) Nest Doorbell (zasilany z sieci) Identyfikator nadany zdarzeniom w ramach 1 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 z cechą CameraClipPreview.

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

Użyj go w połączeniu z poleceniem GenerateImage, aby pobrać obraz z kamery powiązany z tym wydarzeniem.

 string
Przykład: „M7S78ZiC4dTyGf_fPHczuRv26r...”

Pola ładunku zdarzenia

Pole Opis Typ danych
eventId Unikalny identyfikator zdarzenia. string
Przykład: „d582ccc6-0de9-4cf3-a9ed-cc3b39218c97”
timestamp Godzina wystąpienia zdarzenia. string
Przykład: „2019-01-01T00:00:01Z”.
resourceUpdate Obiekt ze szczegółowymi informacjami o aktualizacji zasobu. object
userId Unikalny, zaciemniony identyfikator, który reprezentuje użytkownika. string
Przykład: „AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi”
eventThreadId Można zaktualizować Unikalny identyfikator wątku zdarzenia. string
Przykład: „d67cd3f7-86a7-425e-8bb3-462f92ec9f59”.
eventThreadState Do aktualizacji Stan wątku zdarzenia. 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) zawsze będzie obecny w tym obiekcie. object

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

Błędy

W odniesieniu do tej cechy mogą zostać zwrócone następujące kody błędów:

Komunikat o błędzie RPC Rozwiązywanie problemów
Nie można już pobrać zdjęcia z aparatu. DEADLINE_EXCEEDED Obrazy zdarzenia wygasają po 30 sekundach po opublikowaniu zdarzenia. Pamiętaj, aby pobrać zdjęcie przed upływem ważności.
Identyfikator zdarzenia nie należy do kamery. FAILED_PRECONDITION Użyj prawidłowej wartości eventID zwracanej przez zdarzenie zarejestrowane przez kamerę.

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