Шаг 4. Подключение агента и настройка обмена сообщениями

Обновлено 22 декабря 2024

Установите на контроллер или компьютер MQTT-клиент. Например, для ПК подойдет MXTTX.
В MQTT-клиенте введите данные для подключения к облаку умного дома Sber. Поля в вашем ПО могут называться иначе, используйте похожие по смыслу:
- Name — Sber Smart Home или другое удобное.
- Client ID — произвольный идентификатор вашего MQTT-клиента или контроллера.
- Host — адрес MQTT-сервера умного дома Sber. Его вы узнали на шаге 1. Например, mqtts://mqtt-partners.iot.sberdevices.ru.
- Port — используемый порт. Его вы также узнали на шаге 1. Например, 8883.
- Username, Password — логин и пароль, полученные для агента или контроллера на шаге 1.
Создайте устройства на основе заведенных на шаге 3 моделей. Например, чтобы создать датчик температуры и влажности на основе модели my_temp_sensor, отправьте в топик sberdevices/v1/username/up/config следующее сообщение:
```
{
    "devices": [
        {
            "id": "temp1",
            "name": "temp1",
            "default_name": "temp1",
            "model_id": "my_temp_sensor"
        }
    ]
}
```
Обратите внимание, что model_id обязательно должен совпадать с ID одной из моделей, созданной вами в Studio на шаге 3.

Для отправки сообщений с состояниями устройств используйте топик sberdevices/v1/username/up/status. Например, чтобы передать текущую температуру и признак наличия связи для датчика температуры и влажности с идентификатором temp1:

{
    "devices":{
        "temp1":{
            "states":[
                {
                    "key":"online",
                    "value":{"type":"BOOL","bool_value":true}
                },
                {
                    "key":"temperature",
                    "value":{"type":"INTEGER","integer_value":256}
                }
            ]
        }
    }
}

Проверьте, что все сработало. В приложении Салют для Android или в веб-версии приложения Салют авторизуйтесь с тем же номером телефона, который использовали для регистрации в Studio. Затем нажмите
→ Устройства других производителей, выберите агента или контроллер и обновите список устройств.
В список устройств добавятся созданные вами устройства. Если вы добавляли датчик температуры и влажности из примеров выше, в приложении вы увидите его с температурой 25,6 °C.
Добавленные устройства можно полноценно использовать: добавлять в сценарии, переносить между комнатами умного дома и др. Подробнее читайте в справке умного дома Sber для пользователей.
При необходимости настройте обработку MQTT-клиентом сообщений из облака умного дома Sber. Список всех топиков смотрите в разделе Протокол для интеграций MQTT.