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

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

sdm.devices.traits.CameraClipPreview

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

Поля

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

Команды

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

События

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

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

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

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

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

Событие ClipPreview

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

{
  "eventId" : "fe2e82ff-0dca-49f1-9c06-c75186a35947",
  "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
Пример: «fe2e82ff-0dca-49f1-9c06-c75186a35947»
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.