Antes de usar os SDKs do ApsaraMQ for MQTT para enviar e receber mensagens, crie os recursos correspondentes, como instâncias, tópicos e grupos, no console do ApsaraMQ for MQTT. Cada recurso corresponde a um parâmetro na configuração do cliente.
Pré-requisitos
Antes de começar, verifique se você:
Etapa 1: Criar uma instância
A instância é uma máquina virtual que hospeda tópicos e grupos e fornece o endpoint para conexão dos clientes SDK.
Faça login no console do ApsaraMQ for MQTT. No painel de navegação à esquerda, clique em Instances.
Na barra de navegação superior, selecione uma região. No canto superior esquerdo, clique em Create Instance.
No painel exibido, mantenha o método de faturamento padrão Subscription e clique em OK.
Na página de compra, selecione as especificações da instância conforme seus requisitos, aceite os termos de serviço e clique em Buy Now. Para comparar as edições disponíveis e seus recursos, consulte Edições de instância.
Conclua o pagamento na página do pedido.
Após o pagamento, clique em Console para retornar ao console do ApsaraMQ for MQTT.
Etapa 2: Obter o endpoint da instância
O endpoint é a URL de conexão usada pelos clientes SDK para acessar a instância. Esse valor é obrigatório para configurar o envio de mensagens no código.
No console do ApsaraMQ for MQTT, acesse Instances e selecione a região onde a instância está implantada.
Clique no nome da instância ou em Details na coluna Actions para abrir a página Instance Details.
-
Clique na aba Endpoints. Localize e copie o public endpoint.
Etapa 3: Criar um tópico
O tópico é o canal de mensagens usado por publicadores e assinantes para trocar dados. O protocolo MQTT aceita tópicos multinível organizados em hierarquia e separados por barras (/).
Crie os tópicos pai no console.
Defina os subtópicos diretamente no código; não é necessário criá-los no console.
Formato de nomenclatura do tópico: <parent-topic>/<level-2-topic>/<level-3-topic>
Exemplo: SendMessage/demo/producer
O comprimento combinado do tópico pai e de todos os níveis de subtópico não pode exceder 64 caracteres. Para mais detalhes sobre a estrutura de tópicos, consulte Termos .
Para criar um tópico pai:
Na página Instance Details, clique em Topics no painel de navegação à esquerda.
No canto superior esquerdo da página Topics, clique em Create Topic.
No painel Create Topic, insira um Name (por exemplo,
SendMessage) e uma Description e clique em OK.
Etapa 4: Criar um grupo
O grupo gerencia seus clientes MQTT. Para mais detalhes, consulte Termos.
Na página Instance Details, clique em Groups no painel de navegação à esquerda.
No canto superior esquerdo da página Groups, clique em Create Group.
No painel Create Group, insira um Group ID (por exemplo,
GID_demo) e clique em OK.
Verificar a configuração
Após criar os recursos, confirme se os itens abaixo estão prontos para integração com o SDK:
|
Recurso |
Onde encontrar |
Uso no código SDK como |
|
Endpoint da instância |
Aba Instance Details > Endpoints |
URL de conexão |
|
Tópico pai |
Instance Details > Topics |
Parâmetro de tópico nas chamadas de publicação/assinatura |
|
Group ID |
Instance Details > Groups |
Parâmetro Group ID na configuração do cliente |
Próximos passos
Com a instância, o tópico e o grupo configurados, inicie a criação dos fluxos de trabalho de mensagens: