Схема дверного звонка

Nest Doorbell (старая модель) Nest Doorbell (на батарейках) Nest Doorbell (проводная модель)

sdm.devices.traits.DoorbellChime

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

Поля

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

Команды

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

События

Перезвон

Обновляемый

Был нажат дверной звонок.

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

Событие звонка

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

{
  "eventId" : "9a4d354b-421c-4add-aaf7-57a3886413c7",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "M20RrfMUOkuFXU9s_gLVAg40Iz..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Поля событий Chime

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

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

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

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

 string
Пример: «M20RrfMUOkuFXU9s_gLVAg40Iz...»

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

Поле Описание Тип данных
eventId Уникальный идентификатор события. string
Пример: «9a4d354b-421c-4add-aaf7-57a3886413c7»
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

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

Ошибки

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

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

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