MQTT

MQTT стає доступним, коли на запиті WebSocket вибрано протокол mqtt.

Конфігурація

Поле	Роль
URL	Адреса брокера (mqtt://, mqtts:// або WebSocket)
Тема	Тема, яку задає поле Подія
Повідомлення	Опублікований вміст
QoS	0, 1 або 2 — використовується і під час публікації, і під час підписки
Утримувати (retain)	Позначає повідомлення як утримуване брокером
Ідентифікатор клієнта	Обчислюється через Handlebars; генерується автоматично, якщо поле порожнє
Користувач / Пароль	Облікові дані брокера; пароль приймає значення типу «Секрет»
Keepalive	У секундах
Підписатися на тему	Типово увімкнено: під час з’єднання Restorm підписується на тему запиту

Тема приймає {{variables}} — capteurs/{{site}}/{{capteurId}} є цілком допустимою темою.

Заповіт (Last Will and Testament)

Чотири поля описують повідомлення, яке брокер опублікує, якщо ваш клієнт раптово зникне: тема, вміст, QoS і утримання заповіту.

Це саме те, що потрібно, щоб перевірити поведінку вашої системи в разі нечистого від’єднання: налаштуйте заповіт, обірвіть з’єднання й переконайтеся, що передплатник реагує.

Повторне з’єднання

Клієнт MQTT перез’єднується автоматично, із межею в десять спроб.

У сценарії

З’єднання MQTT (підписується на тему запиту й генерує подію для кожного отриманого повідомлення), Публікація MQTT (публікує з QoS та утриманням із запиту) і Закриття з’єднання MQTT. Див. З’єднання та потоки.

Режим сервера

Restorm уміє розміщувати локальний брокер MQTT: по одному брокеру на порт, доступний через сирий TCP і через шлюз «MQTT поверх WebSocket». Див. Імітація WebSocket, Socket.IO та MQTT.

Імпорт з AsyncAPI

Документ AsyncAPI, канали якого використовують протокол mqtt, безпосередньо породжує запити MQTT (по одному на канал, для публікації та для підписки) зі зразками вмісту, побудованими зі схеми повідомлень. Див. Імпорт AsyncAPI.