Схема CameraClipPreview

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

sdm.devices.traits.CameraClipPreview

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

Поля

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

Команды

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

События

ClipPreview

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

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

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

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

Событие ClipPreview

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

{
  "eventId" : "bcba3d0c-c6ab-44dc-8f7d-3c2c8a1ee385",
  "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
Пример: "bcba3d0c-c6ab-44dc-8f7d-3c2c8a1ee385".
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 приведен в справочнике.