Схема CameraClipPreview

Nest Doorbell (battery) Nest Doorbell (wired)

sdm.devices.traits.CameraClipPreview

Эта функция присуща любому устройству, поддерживающему загрузку предварительного просмотра видеоролика.

Поля

Для этого признака нет доступных полей.

Команды

Для этого признака нет доступных команд.

События

Предварительный просмотр клипа

A video clip is available for preview.

Предварительный просмотр клипа — это видеофайл из 10 кадров в формате mp4. Вы можете выбрать отображение видеофайла mp4 или перекодировать его в другой формат (например, анимированный GIF), чтобы показать полную последовательность из 10 кадров. При выборе метода предварительного просмотра клипа следует учитывать возможности клиентского приложения устройства.

Данное событие поддерживается для следующих событий:

Тип Элемент Описание
Событие Событие движения трейта CameraMotion Motion has been detected by the camera.
Событие Person event of the CameraPerson trait A person has been detected by the camera.
Событие Chime event of the DoorbellChime trait Дверной звонок нажат.
Используйте eventSessionId , чтобы связать это событие и соответствующий previewUrl с одним или несколькими поддерживаемыми событиями.

ClipPreview event

Полезная нагрузка 

{
  "eventId" : "4a3ffc61-b738-4c61-8397-51e47f1bdb74",
  "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"
  ]
}

ClipPreview event fields

Поле Описание Тип данных
eventSessionId Идентификатор, присваиваемый событиям, происходящим в рамках одной сессии связанных событий. Может использоваться для объединения событий. string
Пример: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
previewUrl URL-адрес для предварительного просмотра видеоролика. Видеокодек по умолчанию — H264. string
Example: "https:// previewUrl /..."

Поля полезной нагрузки события

Поле Описание Тип данных
eventId Уникальный идентификатор мероприятия. string
Example: "4a3ffc61-b738-4c61-8397-51e47f1bdb74"
timestamp Время, когда произошло событие. string
Пример: "2019-01-01T00:00:01Z"
resourceUpdate Объект, содержащий подробную информацию об обновлении ресурса. object
userId Уникальный, зашифрованный идентификатор, представляющий пользователя. string
Пример: «AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi»
resourceGroup Объект, указывающий на ресурсы, которые могут иметь аналогичные обновления для данного события. Ресурс самого события (из объекта resourceUpdate ) всегда будет присутствовать в этом объекте. object

Более подробную информацию о различных типах мероприятий и порядке их проведения можно найти в разделе «Мероприятия» .

Preview the clip

To preview the clip, make a GET call to the previewUrl using the OAuth access token in the HTTP Authorization header:

Предварительный просмотр 

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

Ошибки

Полный список кодов ошибок API см. в Справочнике кодов ошибок API.