Schemat CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

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

Pola

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

Polecenia

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

Wydarzenia

ClipPreview

Klip wideo jest dostępny do podglądu.

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 Dzwonek został naciśnięty.
Użyj parametru eventSessionId, aby powiązać to zdarzenie i powiązany z nim parametr previewUrl z co najmniej 1 obsługiwanym zdarzeniem.

Zdarzenie ClipPreview

Ładunek

{
  "eventId" : "1bb063ae-09d3-4fb3-b7a3-6795e5e18d47",
  "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 być używany do konsolidowania zdarzeń. string
Przykład: „CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
previewUrl Adres 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: „1bb063ae-09d3-4fb3-b7a3-6795e5e18d47”
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, zniekształcony 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. Zasób samego zdarzenia (z obiektu resourceUpdate) będzie zawsze obecny w tym obiekcie. object

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

Wyświetlanie podglądu klipu

Aby wyświetlić podgląd klipu, wywołaj metodę GET na adres 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.