Схема CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

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

Поля

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

Команды

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

События

ClipPreview

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

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

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

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

Событие ClipPreview

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

{
  "eventId" : "3b38e05a-38d8-4b7b-a7cb-7e1a2a3bdbd8",
  "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
Пример: "3b38e05a-38d8-4b7b-a7cb-7e1a2a3bdbd8"
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.