Схема CameraSound

Nest Cam (устаревшая версия) Nest Hub Max Nest Doorbell (устаревшая версия)

sdm.devices.traits.CameraSound

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

Поля

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

Команды

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

События

Звук

Sound has been detected by the camera.

Sound event

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

{
  "eventId" : "cc022ab1-f442-4bcd-bc87-3bc53357ce01",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraSound.Sound" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "bnXJxlCcunfcYEaLMmhYqQ4gQD..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Sound event fields

Поле Описание Тип данных
eventSessionId Идентификатор, присваиваемый событиям, происходящим в рамках одной сессии связанных событий. Может использоваться для объединения событий. string
Пример: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId Идентификатор, связанный с событием.

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

 string
Example: "bnXJxlCcunfcYEaLMmhYqQ4gQD..."

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

Поле Описание Тип данных
eventId Уникальный идентификатор мероприятия. string
Example: "cc022ab1-f442-4bcd-bc87-3bc53357ce01"
timestamp Время, когда произошло событие. string
Пример: "2019-01-01T00:00:01Z"
resourceUpdate Объект, содержащий подробную информацию об обновлении ресурса. object
userId Уникальный, зашифрованный идентификатор, представляющий пользователя. string
Пример: «AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi»
resourceGroup Объект, указывающий на ресурсы, которые могут иметь аналогичные обновления для данного события. Ресурс самого события (из объекта resourceUpdate ) всегда будет присутствовать в этом объекте. object

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

Ошибки

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

Сообщение об ошибке РПК Поиск неисправностей
Camera image is no longer available for download. DEADLINE_EXCEEDED Event images expire 30 seconds after the event is published. Make sure to download the image prior to expiration.
Event id does not belong to the camera. FAILED_PRECONDITION Используйте правильный eventID возвращаемый событием камеры.

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