КамераЧеловек Схема

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

sdm.devices.traits.CameraPerson

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

Поля

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

Команды

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

События

Человек

Обновляемый

Камера обнаружила человека.

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

Личное событие

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

{
  "eventId" : "d9a2b0e9-8578-46f8-899a-d741975d1c5b",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "QKlbpmRJYrfkoK3vyiiLoUuNry...",
      }
    }
  }
  "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
Пример: «QKlbpmRJYrfkoK3vyiiLoUuNry...»

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

Поле Описание Тип данных
eventId Уникальный идентификатор события. string
Пример: «d9a2b0e9-8578-46f8-899a-d741975d1c5b»
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.