Schemat DoorbellChime

Nest Doorbell (starsza wersja) Nest Doorbell (zasilany z sieci) Nest Doorbell (zasilany z sieci) 

sdm.devices.traits.DoorbellChime

Ta cecha należy do każdego urządzenia, które obsługuje dzwonek do drzwi i powiązane zdarzenia naciśnięcia.

Pola

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

Polecenia

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

Wydarzenia

Dzwonki

Możliwość aktualizacji 

ktoś nacisnął dzwonek.

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 zawartości kolejnego zdarzenia z tym samym eventThreadId.

Wydarzenie gongu

Ładunek

{
  "eventId" : "cbcfe550-7747-4258-98a9-8703306ed57e",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "oQy2FDX-yKBujCbebQbDpyb8pn..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Pola zdarzenia dzwonka

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 Doorbell (starsza wersja) Identyfikator powiązany ze zdarzeniem.

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

 string
Przykład: „oQy2FDX-yKBujCbebQbDpyb8pn…”

Pola ładunku zdarzeń

Pole Opis Typ danych
eventId Unikalny identyfikator zdarzenia. string
Przykład: „cbcfe550-7747-4258-98a9-8703306ed57e”.
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.