Схема CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

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

Поля

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

Команды

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

События

ClipPreview

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

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

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

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

Событие ClipPreview

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

{
  "eventId" : "831987e3-e26e-496c-9b72-258b127dac8a",
  "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
Пример: "831987e3-e26e-496c-9b72-258b127dac8a".
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 приведен в справочнике.