Schemat CameraClipPreview

Nest Doorbell (zasilany z sieci) 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

Nie ma żadnych pól dostępnych dla tej cechy.

Polecenia

W przypadku tej cechy nie ma dostępnych poleceń.

Wydarzenia

ClipPreview

Klip wideo jest dostępny do podglądu.

Podgląd klipu to plik wideo w formacie mp4 zawierający 10 klatek. Możesz wyświetlić plik wideo mp4 lub przekonwertować go na inny format (np. animowany GIF), aby wyświetlić pełną sekwencję 10 ramek. 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 Ruch atrybutu CameraMotion Kamera wykryła ruch.
Zdarzenie Zdarzenie Osoba atrybutu CameraPerson Kamera wykryła osobę.
Zdarzenie zdarzenie Chime atrybutu DoorbellChime, ktoś nacisnął dzwonek.
Użyj tagu eventSessionId, aby powiązać to zdarzenie i powiązane z nim zdarzenie previewUrl z co najmniej 1 obsługiwanym zdarzeniem.

Zdarzenie ClipPreview

Ładunek

{
  "eventId" : "cac055e6-c8df-471f-94ff-6cbfd6c7e969",
  "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 pojedynczej sesji powiązanych zdarzeń. Może służyć 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 zdarzeń

Pole Opis Typ danych
eventId Unikalny identyfikator zdarzenia. string
Przykład: „cac055e6-c8df-471f-94ff-6cbfd6c7e969”.
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, zanonimizowany 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. Zasoby zdarzenia (z obiektu resourceUpdate) będą zawsze obecne w tym obiekcie. object

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

Wyświetl podgląd klipu

Aby wyświetlić podgląd klipu, wyślij żądanie GET do adresu previewUrl, używając tokena dostępu OAuth w nagłówku HTTP Authorization:

Podgląd

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

Błędy

Pełną listę kodów błędów interfejsu API znajdziesz w przewodniku po kodach błędów interfejsu API.