Schemat podglądu CameraClip

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

sdm.devices.traits.CameraClipPreview

Ta cecha jest przypisana do każdego urządzenia, które obsługuje pobieranie podglądu klipów.

Pola

Brak dostępnych pól dla tej cechy.

Polecenia

Nie ma dostępnych poleceń dla tej cechy.

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 transkodować go do innego formatu (np. animowanego GIF-a), aby wyświetlić pełną sekwencję 10 klatek. Wybierając metodę podglądu klipu, weź pod uwagę możliwości klienta urządzenia.

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

Typ Element Opis
Zdarzenie Zdarzenie ruchu związane z cechą CameraMotion Kamera wykryła ruch.
Zdarzenie Zdarzenie dotyczące osoby związanej z cechą CameraPerson Kamera wykryła osobę.
Zdarzenie Dzwonek związany z cechą gongu dzwonka Naciśnięto dzwonek.
Użyj interfejsu eventSessionId, aby powiązać to zdarzenie i powiązane z nim zdarzenie previewUrl z co najmniej 1 obsługiwanym zdarzeniem.

Zdarzenie ClipPreview

Ładunek

{
  "eventId" : "54e55063-25e6-44a5-9aa7-704405bb1c91",
  "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 nadany zdarzeniom w ramach 1 sesji powiązanych zdarzeń. Może służyć do konsolidowania wydarzeń. string
Przykład: „CjY5Y3VKaTZwR3o4Y19YbTVfMF...”
previewUrl Adres URL, pod którym wyświetla się 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: „54e55063-25e6-44a5-9aa7-704405bb1c91”
timestamp Godzina 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, który reprezentuje 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) zawsze będzie obecny w tym obiekcie. object

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

Zobacz podgląd klipu

Aby wyświetlić podgląd klipu, wykonaj wywołanie GET do interfejsu previewUrl, korzystając z 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łędów interfejsu API.