Перейти к основному содержимому

MQTT (глазами разработчика)

Протокол обмена сообщениями publish/subscribe. Все строится вокруг подписанных топиков (получение) и публикуемых топиков (отправка); параметры лежат в настройках MQTT запроса.

Как настроить в UI​

Заполните настройки подключения MQTT-запроса:

НастройкаЗначение
Client ID (clientId)Идентификатор этого подключения
Список подписокНабор топиков + QoS, автоподписка после подключения
Топик публикацииТопик по умолчанию, куда отправляются сообщения
QoS / retain публикацииКачество обслуживания и флаг retain при отправке
  • Подстановочные знаки топиков: # соответствует нескольким уровням, + — одному уровню (например qr/manual/#).
  • QoS: 0 (не более одного раза) / 1 (не менее одного раза) / 2 (ровно один раз).
  • В хост идет адрес брокера, порт хранится отдельно (например 127.0.0.1:18884); mqtts:// использует TLS.

Основной поток​

Как пользоваться​

  1. Создайте MQTT-запрос и настройте clientId, подписки и топик публикации по таблице выше.
  2. Подключение: сессия автоматически подписывается по вашей конфигурации и запоминает топик публикации по умолчанию.
  3. Публикация: отправьте контент в топик публикации (топик/QoS/retain можно менять на каждое сообщение); пустые payload допустимы.
  4. Получение: входящие сообщения отображаются в реальном времени — и ваши собственные сообщения-эхо, попавшие в подписки, и другие сообщения, которые брокер пушит в подписанные топики.
  5. В течение сессии можно подписываться / отписываться; закройте сессию по завершении.

Проверенное поведение​

Предподписка qr/manual/# + публикация {"evt":"auto-sub"} в qr/manual/hello → возвращается PUBACK (QoS1 acknowledged), и тело сообщения-эхо приходит — замкнутый цикл отправки/получения.

Важные нюансы​

  • Не получаете свою публикацию: убедитесь, что топик публикации совпадает с одной из ваших подписок (например обе под qr/manual/#).
  • Подписки, добавленные или удаленные во время выполнения, действуют только в текущей сессии — долгоживущие подписки кладите в конфигурацию запроса.
  • Долгие соединения занимают квоту и освобождаются при простое; закрывайте их после отладки.

Связанное: подстановочные знаки подписок и QoS объяснены выше; подключение берется из mqtt Pre-URL окружения (см. concepts).