Schemat CameraClipPreview

Nest Doorbell (na baterie) Nest Doorbell (zasilany z sieci) 

sdm.devices.traits.CameraClipPreview

Ta cecha należy do każdego urządzenia, które obsługuje pobieranie podglądu klipu.

Pola

Brak dostępnych pól dla tej cechy.

Polecenia

W przypadku tej cechy nie są dostępne żadne polecenia.

Wydarzenia

ClipPreview

Dostępny jest podgląd klipu wideo.

Podgląd klipu to 10-klatkowy plik wideo w formacie MP4. Możesz wyświetlić plik wideo MP4 lub przekodować go na inny format (np. animowany GIF), aby wyświetlić pełną sekwencję 10 klatek. Podczas wybierania metody podglądu klipu należy wziąć pod uwagę możliwości klienta urządzenia.

To zdarzenie jest obsługiwane w przypadku tych zdarzeń:

Typ Element Opis
Zdarzenie Zdarzenie Motion cechy CameraMotion Kamera wykryła ruch.
Zdarzenie Zdarzenie Person cechy CameraPerson Kamera wykryła osobę.
Zdarzenie Zdarzenie Chime cechy DoorbellChime Naciśnięto dzwonek.
Użyj eventSessionId, aby powiązać to zdarzenie i powiązane z nim previewUrl z co najmniej 1 obsługiwanym zdarzeniem.

Zdarzenie ClipPreview

Ładunek

{
  "eventId" : "6c648daa-5aa9-47b4-80f4-05a22ef953e2",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraClipPreview.ClipPreview" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "previewUrl" : "https://previewUrl/..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Pola zdarzenia ClipPreview

Pole Opis Typ danych
eventSessionId Identyfikator nadawany zdarzeniom występującym w ramach jednej sesji powiązanych zdarzeń. Może służyć do konsolidacji zdarzeń. string
Przykład: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...”.
previewUrl URL, pod którym można wyświetlić podgląd klipu wideo. Domyślny kodek wideo to H264. string
Przykład: „https://previewUrl/...”

Pola ładunku zdarzenia

Pole Opis Typ danych
eventId Unikalny identyfikator zdarzenia. string
Przykład: „6c648daa-5aa9-47b4-80f4-05a22ef953e2”
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, celowo zniekształcony identyfikator reprezentujący użytkownika. string
Przykład: „AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi”
resourceGroup Obiekt, który wskazuje zasoby, które mogą mieć podobne aktualizacje do tego zdarzenia. Zasób samego zdarzenia (z obiektu resourceUpdate) będzie zawsze obecny w tym obiekcie. object

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

Wyświetlanie podglądu klipu

Aby wyświetlić podgląd klipu, wywołaj metodę GET na previewUrl, używając tokena dostępu OAuth w nagłówku autoryzacji HTTP:

Podgląd

curl -H 'Authorization: Bearer access-token' \
  https://previewUrl/...

Błędy

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