Schemat CameraSound

Nest Cam (starsza wersja) Nest Hub Max Nest Doorbell (starsza wersja) 

sdm.devices.traits.CameraSound

Ta cecha należy do każdego urządzenia, które obsługuje zdarzenia wykrywania dźwięku.

Pola

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

Polecenia

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

Wydarzenia

Dźwięk

Kamera wykryła dźwięk.

Zdarzenie dźwiękowe

Ładunek

{
  "eventId" : "ff7e1196-0104-4dba-ac83-b98d1fc7cbda",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraSound.Sound" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "khwNE_n9nr39cK-FAjTcoejjqz..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Pola zdarzenia dźwiękowego

Pole Opis Typ danych
eventSessionId Identyfikator nadawany zdarzeniom występującym w ramach pojedynczej sesji powiązanych zdarzeń. Może służyć do konsolidowania zdarzeń. string
Przykład: „CjY5Y3VKaTZwR3o4Y19YbTVfMF…”
eventId Identyfikator powiązany ze zdarzeniem.

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

 string
Przykład: „khwNE_n9nr39cK-FAjTcoejjqz...”.

Pola ładunku zdarzeń

Pole Opis Typ danych
eventId Unikalny identyfikator zdarzenia. string
Przykład: „ff7e1196-0104-4dba-ac83-b98d1fc7cbda”.
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”.
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.