Схема CameraPerson

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

sdm.devices.traits.CameraPerson

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

Поля

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

Команды

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

События

Человек

Обновляемый

Камера зафиксировала человека.

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

Событие с участием человека

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

{
  "eventId" : "9fa864a0-9169-45b5-bd6d-0aecf5c0819b",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "abWpUrADjCW-d0MH5q43gJrujt...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Поля событий человека

Поле Описание Тип данных
eventSessionId Nest Doorbell (battery) Nest Doorbell (wired) An ID given to events occurring as part of a single session of related events. May be used for consolidating events.

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

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

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

 string
Пример: "abWpUrADjCW-d0MH5q43gJrujt..."

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

Поле Описание Тип данных
eventId Уникальный идентификатор мероприятия. string
Пример: "9fa864a0-9169-45b5-bd6d-0aecf5c0819b"
timestamp Время, когда произошло событие. string
Пример: "2019-01-01T00:00:01Z"
resourceUpdate Объект, содержащий подробную информацию об обновлении ресурса. object
userId Уникальный, зашифрованный идентификатор, представляющий пользователя. string
Пример: «AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi»
eventThreadId Обновляемый. Уникальный идентификатор потока событий. string
Пример: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState Обновляемый поток событий. string
Значения: "НАЧАЛО", "ОБНОВЛЕНО", "ЗАВЕРШЕНО"
resourceGroup An object that indicates resources that might have similar updates to this event. The resource of the event itself (from the resourceUpdate object) will always be present in this object. object

Более подробную информацию о различных типах мероприятий и порядке их проведения можно найти в разделе «Мероприятия» .

Ошибки

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

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

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