Схема дверного звонка/звонка
Nest Doorbell (старая модель) Nest Doorbell (на батарейках) Nest Doorbell (проводная модель)
sdm.devices.traits.DoorbellChime
Эта функция присуща любому устройству, поддерживающему дверной звонок и связанные с ним события нажатия кнопок.
Поля
Для этого признака нет доступных полей.
Команды
Для этого признака нет доступных команд.
События
Колокольчик
ОбновляемыйДверной звонок нажат.
Это событие поддерживает обновляемые уведомления. Существующие уведомления приложения, созданные на основе этого события, могут быть обновлены с использованием содержимого последующего события с тем же eventThreadId .
Мероприятие «Колокольчики»
Полезная нагрузка
{
"eventId" : "b33e2148-e0b9-424c-af48-ef77522dffb0",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : {
"name" : "enterprises/project-id/devices/device-id",
"events" : {
"sdm.devices.events.DoorbellChime.Chime" : {
"eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
"eventId" : "J5_1IAExmkrAVDQpcCnckhTARb..."
}
}
}
"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Пример: "J5_1IAExmkrAVDQpcCnckhTARb..." |
Поля полезной нагрузки события
| Поле | Описание | Тип данных |
|---|---|---|
eventId | Уникальный идентификатор мероприятия. | stringПример: "b33e2148-e0b9-424c-af48-ef77522dffb0" |
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 |
Более подробную информацию о различных типах мероприятий и порядке их проведения можно найти в разделе «Мероприятия» .
Ошибки
В связи с этим признаком могут быть возвращены следующие коды ошибок:
| Сообщение об ошибке | РПК | Поиск неисправностей |
|---|---|---|
| Изображение с камеры больше недоступно для скачивания. | DEADLINE_EXCEEDED | Изображения событий становятся недоступны через 30 секунд после публикации события. Убедитесь, что вы загрузили изображение до истечения этого срока. |
| Идентификатор события не относится к камере. | FAILED_PRECONDITION | Используйте правильный eventID возвращаемый событием камеры. |
Полный список кодов ошибок API см. в Справочнике кодов ошибок API.