Схема CameraMotion

Nest Cam (устаревшая версия) Nest Cam (наружная или внутренняя, на батарейках) Nest Cam с прожектором Nest Cam (внутренняя, проводная) Nest Hub Max Nest Doorbell (устаревшая версия) Nest Doorbell (на батарейках) Nest Doorbell (проводной)

sdm.devices.traits.CameraMotion

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

Поля

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

Команды

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

События

Движение

Обновляемый

Камера зафиксировала движение.

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

Событие движения

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

{
  "eventId" : "41b08a9f-4b41-4de0-9519-9b6e34c348b2",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraMotion.Motion" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "aDlJwle-eXeIoQwjOP41Xxxw5M...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Поля событий движения

Поле Описание Тип данных
eventSessionId Nest Doorbell (батарейный) Nest Doorbell (проводной) Идентификатор, присваиваемый событиям, происходящим в рамках одного сеанса связанных событий. Может использоваться для объединения событий.

Используйте его, чтобы связать это событие с соответствующим событием ClipPreview свойства CameraClipPreview.

 string
Пример: «CjY5Y3VKaTZwR3o4Y19YbTVfMF...»
eventId Nest Cam (устаревшая версия) Nest Hub Max Nest Doorbell (устаревшая версия) Идентификатор, связанный с событием.

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

 string
Пример: "aDlJwle-eXeIoQwjOP41Xxxw5M..."

Поля полезной нагрузки события

Поле Описание Тип данных
eventId Уникальный идентификатор события. string
Пример: "41b08a9f-4b41-4de0-9519-9b6e34c348b2"
timestamp Время, когда произошло событие. string
Пример: "2019-01-01T00:00:01Z"
resourceUpdate Объект, содержащий подробную информацию об обновлении ресурса. object
userId Уникальный, скрытый идентификатор, представляющий пользователя. string
Пример: «AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi»
eventThreadId Обновляемый Уникальный идентификатор потока событий. string
Пример: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState Обновляемое Состояние потока событий. string
Значения: «НАЧАТО», «ОБНОВЛЕНО», «ЗАВЕРШЕНО»
resourceGroup Объект, указывающий ресурсы, которые могут иметь похожие обновления для этого события. Ресурс самого события (из объекта resourceUpdate ) всегда будет присутствовать в этом объекте. object

Дополнительную информацию о различных типах мероприятий и принципах их работы см. в разделе «События» .

Ошибки

В отношении этого признака могут быть возвращены следующие коды ошибок:

Сообщение об ошибке РПК Поиск неисправностей
Изображение с камеры больше не доступно для загрузки. DEADLINE_EXCEEDED Изображения событий истекают через 30 секунд после публикации события. Обязательно загрузите изображение до истечения срока действия.
Идентификатор события не принадлежит камере. FAILED_PRECONDITION Используйте правильный eventID , возвращаемый событием камеры.

Полный список кодов ошибок API см. в Справочнике кодов ошибок API.