ym88659208ym87991671
Передача команд на изменение статуса (commands) | Документация SmartMarket
Skip to main content

Передача команд на изменение статуса (commands)

Направление: облако → контроллер.

Умный дом Sber отправляет приложению-агенту на контроллере запрос на изменение состояния устройств.

Пример ситуации использования:

  1. Пользователь в приложении Салют, на SberPortal, SberBox или другом устройстве с ассистентами Салют изменяет состояние лампы, например, выключает ее.
  2. Умный дом отправляет в приложение-агент на контроллере запрос на изменение состояния лампы.
  3. Агент транслирует запрос на контроллер, контроллер выключает лампу.

Формат сообщения

Топик:

sberdevices/v1/<username>/down/commands
ПараметрТипОбязательный?Описание
usernamestring✔︎Логин, с которым осуществляется подключение к MQTT-серверу Sber (см. раздел «Получение данных для подключения контроллера к облаку Sber» для интеграторов и для DIY-энтузиастов)

Тело сообщения:

ПолеТипОбязательное?Описание
devicesdict<string object>✔︎Устройства, состояние которых нужно изменить. Для каждого устройства передаются ID устройства в системе вендора и новое состояние его функций
IDstring✔︎ID устройства в системе вендора
stateslist<object>✔︎Список новых состояний (см. Состояние устройства (state))
{
"devices": {
"id": {
"states": [
{
"key": string,
"value": {
"type": string,
"type_value": object
}
},
{
// ...
}
]
}
}
}

Пример сообщения

Умный дом Sber отправляет приложению-агенту на контроллере запрос на изменение состояния розетки.

Топик:

sberdevices/v1/1234567/down/commands

Тело сообщения:

{
"devices": {
"ABCD_003": {
"states": [
{
"key": "online",
"value": {
"type": "BOOL",
"bool_value": true
}
},
{
"key": "on_off",
"value": {
"type": "BOOL",
"bool_value": true
}
}
]
}
}
}
Обновлено 28 апреля 2022

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней