Схема предварительного просмотра CameraClip
Nest Doorbell (на батарейке) Nest Doorbell (проводной)
sdm.devices.traits.CameraClipPreview
Эта особенность свойственна любому устройству, поддерживающему загрузку предварительного просмотра клипа.
Поля
Для этого признака нет доступных полей.
Команды
Для этой особенности нет доступных команд.
События
Предварительный просмотр клипа
Видеоклип доступен для предварительного просмотра.
Превью клипа представляет собой 10-кадровый видеофайл в формате mp4. Вы можете выбрать показ видеофайла mp4 или перекодировать его в другой формат (например, анимированный gif), чтобы отобразить полную последовательность из 10 кадров. При выборе метода предварительного просмотра клипа следует учитывать возможности клиента устройства.
Это событие поддерживается для следующих событий:
Тип | Элемент | Описание |
---|---|---|
Событие | Событие движения свойства CameraMotion | Камера обнаружила движение. |
Событие | Событие Person свойства CameraPerson | Камера обнаружила человека. |
Событие | Событие Chime черты DoorbellChime | Дверной звонок был нажат. |
eventSessionId
чтобы связать это событие и связанный previewUrl
с одним или несколькими поддерживаемыми событиями.Событие ClipPreview
Полезная нагрузка
{ "eventId" : "12fd7993-7305-44e5-847f-d39fe24c32d6",
"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 Пример: «12fd7993-7305-44e5-847f-d39fe24c32d6» |
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.