Схема CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

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

Поля

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

Команды

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

События

ClipPreview

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

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

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

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

Событие ClipPreview

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

{
  "eventId" : "1bb063ae-09d3-4fb3-b7a3-6795e5e18d47",
  "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
Пример: «1bb063ae-09d3-4fb3-b7a3-6795e5e18d47»
timestamp Время, когда произошло событие. string
Пример: «2019-01-01T00:00:01Z»
resourceUpdate Объект, содержащий подробную информацию об обновлении ресурса. object
userId Уникальный, скрытый идентификатор, представляющий пользователя. string
Пример: «AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi»
resourceGroup Объект, указывающий ресурсы, которые могут иметь обновления, аналогичные данному событию. Ресурс самого события (из объекта resourceUpdate ) всегда будет присутствовать в этом объекте. object

Дополнительную информацию о различных типах мероприятий и принципах их работы см. в разделе События.

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

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

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

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

Ошибки

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