MQTT (visão do desenvolvedor)
Um protocolo de mensagens publish/subscribe. Tudo é organizado em torno de tópicos assinados (receber) e tópicos publicados (enviar); parâmetros ficam nas configurações MQTT da requisição.
Como configurar na UI
Preencha as configurações de conexão da requisição MQTT:
| Configuração | Significado |
|---|---|
| Client ID (clientId) | Identidade desta conexão |
| Lista de assinaturas | Conjunto de tópicos + QoS, assinados automaticamente após conectar |
| Tópico de publicação | O tópico padrão para o qual as mensagens são enviadas |
| Publicar QoS / retain | Qualidade de serviço e flag retain ao enviar |
- Curingas de tópico:
#corresponde a múltiplos níveis,+corresponde a um nível (ex.:qr/manual/#). - QoS: 0 (no máximo uma vez) / 1 (pelo menos uma vez) / 2 (exatamente uma vez).
- O host recebe o endereço do broker, a porta é separada (ex.:
127.0.0.1:18884);mqtts://usa TLS.
Fluxo principal
Como usar
- Crie uma requisição MQTT e configure clientId, assinaturas e tópico de publicação conforme a tabela acima.
- Conectar: a sessão assina automaticamente conforme sua configuração e lembra o tópico de publicação padrão.
- Publicar: envie conteúdo para o tópico de publicação (tópico/QoS/retain podem ser alterados por mensagem); payloads vazios são válidos.
- Receber: mensagens recebidas aparecem em tempo real — tanto suas próprias mensagens de loopback que batem nas assinaturas quanto outras mensagens que o broker empurra para tópicos assinados.
- Você pode assinar / cancelar assinatura durante a sessão; feche a sessão ao terminar.
Comportamento verificado
Pré-assinado qr/manual/# + publicar {"evt":"auto-sub"} em qr/manual/hello → retorna PUBACK (QoS1 acknowledged) e o corpo da mensagem de loopback chega — um ciclo fechado de envio/recebimento.
Pontos de atenção
- Não recebe sua própria publicação: confirme que o tópico de publicação corresponde a uma das suas assinaturas (ex.: ambos sob
qr/manual/#). - Assinaturas adicionadas ou removidas em tempo de execução duram apenas a sessão atual — coloque assinaturas duradouras na configuração da requisição.
- Conexões longas ocupam cota e são retomadas quando ociosas; feche-as após a depuração.
Relacionado: curingas de assinatura e QoS explicados acima; a conexão vem do Pre-URL mqtt do ambiente (veja concepts).