Schemat CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

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

Pola

Ta cecha nie ma żadnych pól.

Polecenia

Ta cecha nie ma żadnych poleceń.

Wydarzenia

ClipPreview

Dostępny jest podgląd klipu wideo.

Podgląd klipu to plik wideo z 10 klatkami 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. Przy wyborze 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 ruchu cechy CameraMotion	Kamera wykryła ruch.
Zdarzenie	Zdarzenie osoby cechy CameraPerson	Kamera wykryła osobę.
Zdarzenie	Zdarzenie dzwonka cechy DoorbellChime	Naciśnięto dzwonek.

Użyj eventSessionId, aby powiązać to zdarzenie i powiązany z nim previewUrl z co najmniej 1 obsługiwanym zdarzeniem.

Zdarzenie ClipPreview

Ładunek

{
  "eventId" : "064c2c66-d38f-4e3c-bbe3-9a777c2c7997",
  "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 przypisany do zdarzeń występujących w ramach jednej 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 zdarzenia

Pole	Opis	Typ danych
`eventId`	Unikalny identyfikator zdarzenia.	`string` Przykład: „064c2c66-d38f-4e3c-bbe3-9a777c2c7997”.
`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 ich działaniu znajdziesz w sekcji Wydarzenia.

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 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 dokumentacji kody błędów interfejsu API.