Схема CameraClipPreview

Дверной звонок Nest (на батарейках) Дверной звонок Nest (проводной)

sdm.devices.traits.CameraClipPreview

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

Поля

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

Команды

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

События

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

Видеоролик доступен для предварительного просмотра.

A clip preview is a 10 frame video file in mp4 format. You can choose to show the mp4 video file, or transcode it to another format (for example, an animated gif) in order to show a complete 10 frame sequence. The device client capabilities should be considered when selecting a clip preview method.

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

Тип Элемент Описание
Событие Событие движения трейта CameraMotion Камера зафиксировала движение.
Событие Событие Person трейта CameraPerson Камера зафиксировала человека.
Событие Событие звонка, связанное с характеристикой DoorbellChime. Дверной звонок нажат.
Используйте eventSessionId , чтобы связать это событие и соответствующий previewUrl с одним или несколькими поддерживаемыми событиями.

Мероприятие ClipPreview

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

{
  "eventId" : "3b19c517-6868-4a8a-bf76-1312cc746be0",
  "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

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

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

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

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

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

Для предварительного просмотра видеоролика выполните GET-запрос к адресу previewUrl , используя токен доступа OAuth из заголовка HTTP Authorization:

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

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

Ошибки

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