Schemat CameraClipPreview

Dzwonek Nest (bateria) Dzwonek Nest (przewodowy) 

sdm.devices.traits.CameraClipPreview

Cecha ta dotyczy każdego urządzenia obsługującego pobieranie podglądu klipu.

Pola

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

Polecenia

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

Wydarzenia

ClipPreview

Dostępny jest klip wideo do podglądu.

Podgląd klipu to 10-klatkowy plik wideo w formacie MP4. Możesz wybrać wyświetlanie pliku wideo w formacie mp4 lub przekodować go do innego formatu (na przykład animowanego pliku gif), aby wyświetlić kompletną 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 elementu eventSessionId, aby powiązać to zdarzenie i powiązany z nim element previewUrl z co najmniej 1 obsługiwanym zdarzeniem.

Zdarzenie ClipPreview

Ładunek

{
  "eventId" : "4e87bf2b-d96e-4f83-a41e-871c873ace3b",
  "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 zdarzeń 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: „4e87bf2b-d96e-4f83-a41e-871c873ace3b”
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 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.

Podgląd 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.