Схема DoorbellChime

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

sdm.devices.traits.DoorbellChime

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

Поля

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

Команды

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

События

Звонок

Обновляемый 

Нажата кнопка дверного звонка.

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

Событие Chime

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

{
  "eventId" : "5289f571-74c3-4edb-bf02-1957db7047d1",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "FOgDN255Dsg-EV7T6hzu74MATh..."
      }
    }
  }
  "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 Doorbell (старая модель) Идентификатор, связанный с событием.

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

 string
Пример: "FOgDN255Dsg-EV7T6hzu74MATh..."

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

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

Подробнее о событиях…

Ошибки

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

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

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