Схема CameraPerson

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

sdm.devices.traits.CameraPerson

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

Поля

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

Команды

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

События

Человек

Возможность обновления 

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

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

Событие пользователя

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

{
  "eventId" : "2e0e60a2-8a3a-4b05-b7b3-efa0e974e241",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "BTf4UeEZ61TKO-wcq0FIle9Amr...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Поля событий, связанных с пользователями

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

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

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

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

 string
Пример: "BTf4UeEZ61TKO-wcq0FIle9Amr..."

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

Поле Описание Тип данных
eventId Уникальный идентификатор события. string
Пример: "2e0e60a2-8a3a-4b05-b7b3-efa0e974e241"
timestamp Время, когда произошло событие. string
Пример: "2019-01-01T00:00:01Z"
resourceUpdate Объект, содержащий подробную информацию об обновлении ресурса. object
userId Уникальный зашифрованный идентификатор, представляющий пользователя. string
Пример: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
eventThreadId Возможность обновления Уникальный идентификатор цепочки событий. string
Пример: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState Возможность обновления Статус цепочки событий. string
Значения: "STARTED", "UPDATED", "ENDED".
resourceGroup Объект, указывающий на ресурсы, которые могут иметь похожие обновления для этого события. Ресурс самого события (из объекта resourceUpdate) всегда будет присутствовать в этом объекте. object

Подробнее о типах событий и их работе…

Ошибки

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

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

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