Схема предварительного просмотра CameraClip

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

sdm.devices.traits.CameraClipPreview

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

Поля

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

Команды

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

События

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

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

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

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

Тип	Элемент	Описание
Событие	Событие движения свойства CameraMotion	Камера обнаружила движение.
Событие	Событие Person свойства CameraPerson	Камера обнаружила человека.
Событие	Событие Chime черты DoorbellChime	Дверной звонок был нажат.

Используйте eventSessionId чтобы связать это событие и связанный previewUrl с одним или несколькими поддерживаемыми событиями.

Событие ClipPreview

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

{
  "eventId" : "e2ac698d-0a4e-4a98-a9a0-f6429fb41a72",
  "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` Пример: «e2ac698d-0a4e-4a98-a9a0-f6429fb41a72»
`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.