Schemat CameraClipPreview

Nest Doorbell (na baterie) Nest Doorbell (przewodowy) 

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

Brak dostępnych poleceń dla tej cechy.

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 w formacie MP4 lub transkodować go na inny format (np. animowany GIF), aby wyświetlić pełną sekwencję 10 klatek. Wybierając metodę 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 ruchu właściwości CameraMotion Kamera wykryła ruch.
Zdarzenie Zdarzenie Person o cechach CameraPerson Kamera wykryła jakąś osobę.
Zdarzenie Zdarzenie typu chime związane z dzwonkiem DoorbellChime Naciśnięto dzwonek.
Użyj pola eventSessionId, aby powiązać to zdarzenie i powiązane z nim zdarzenie previewUrl z co najmniej 1 obsługiwanym zdarzeniem.

Zdarzenie ClipPreview

Ładunek

{
  "eventId" : "d8942636-66b1-45cd-a15d-ff6b36eb068c",
  "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 w ramach pojedynczej sesji powiązanych zdarzeń. Może służyć do konsolidowania zdarzeń. string
Przykład: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...”
previewUrl Adres URL, pod którym ma być wyświetlany 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: „d8942636-66b1-45cd-a15d-ff6b36eb068c”
timestamp Czas wystąpienia zdarzenia. string
Przykład: „2019-01-01T00:00:01Z”
resourceUpdate Obiekt ze szczegółowymi informacjami o aktualizacji zasobu. object
userId Unikalny, zaciemniony 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 sposobie ich działania znajdziesz w sekcji Zdarzenia.

Wyświetl podgląd klipu

Aby wyświetlić podgląd klipu, wywołaj metodę GET do interfejsu previewUrl przy użyciu 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 kodu błędu interfejsu API.