Projetos de demonstração - ApsaraMQ for MQTT: Central de Documentação do Alibaba Cloud

Este tópico apresenta os projetos de demonstração do ApsaraMQ for MQTT. Esses projetos oferecem orientações para diversos cenários. Para mais informações, consulte os comentários no código-fonte.

Obtenha demonstrações em várias linguagens

Para acessar o código de exemplo completo, consulte mqtt-demo.

Após baixe e descompactar o pacote, a pasta mqtt-demo-main será criada na sua máquina local. As pastas de nível superior estão organizadas por linguagem de programação. Depure o código conforme necessário.

Java

Cenário	Link para download
Exemplo independente de envio e recebimento de mensagens MQTT	mqtt.demo.java
Exemplo de assinatura MQTT	mqtt.signature.mode.demo.java
Exemplo de token MQTT	mqtt.token.mode.demo.java
Exemplo de criptografia SSL para MQTT	mqtt.ssl.demo.java
Envio de mensagens via MQTT com inscrição no ApsaraMQ for RocketMQ	mqtt.to.rocketmq.demo.java
Envio de mensagens via ApsaraMQ for RocketMQ com inscrição no MQTT	rocketmq.to.mqtt.demo.java
Envio de mensagens ordenadas via MQTT com inscrição ordenada no ApsaraMQ for RocketMQ	mqtt.ordered.msg.demo.java
Notificações assíncronas de status online e offline do cliente MQTT	mqtt.client.status.notice.demo.java
Exemplo de autenticação mútua SSL para MQTT	mqtt.bissl.demo.java

Python

Cenário	Link para download
Exemplo independente de envio e recebimento de mensagens MQTT	mqtt.demo.python
Exemplo de assinatura MQTT	mqtt.signature.mode.demo.python
Exemplo de criptografia SSL para MQTT	mqtt.ssl.mode.demo.python

PHP

Cenário	Link para download
Exemplo independente de envio e recebimento de mensagens MQTT	mqtt.demo.php
Exemplo de assinatura MQTT	mqtt.signature.mode.demo.php
Exemplo de token MQTT	mqtt.token.mode.demo.php
Envio de mensagens ordenadas via MQTT com inscrição ordenada no ApsaraMQ for RocketMQ	mqtt.ordered.msg.demo.php

C

Cenário	Link para download
Exemplo independente de envio e recebimento de mensagens MQTT	mqtt.demo.c
Exemplo de assinatura MQTT	mqtt.signature.mode.demo.c
Exemplo de criptografia SSL para MQTT	mqtt.ssl.demo.c

Nota

Para obter mais bibliotecas de dependência em C, consulte eclipse/paho.mqtt.c.

.NET

Cenário	Link para download
Exemplo independente de envio e recebimento de mensagens MQTT	mqtt.demo.net
Exemplo de assinatura MQTT	mqtt.signature.mode.demo.net
Exemplo de criptografia SSL para MQTT	mqtt.ssl.mode.demo.net

JavaScript

Cenário	Link para download
Exemplo independente de envio e recebimento de mensagens MQTT	mqtt.demo.javascript
Exemplo de assinatura MQTT	mqtt.signature.mode.demo.javascript
Exemplo de criptografia SSL para MQTT	mqtt.ssl.demo.javascript
Exemplo de envio e recebimento de mensagens via WebSocket	mqtt.websocket.demo.javascript

iOS

Cenário	Link para download
Exemplo independente de envio e recebimento de mensagens MQTT	mqtt.demo.ios
Exemplo de assinatura MQTT	mqtt.signature.mode.demo.ios
Exemplo de criptografia SSL para MQTT	mqtt.ssl.demo.ios

Observações sobre o uso das demonstrações

Ao utilizar o ApsaraMQ for MQTT com outros brokers de log de backend, como o ApsaraMQ for RocketMQ, compreenda a estrutura das mensagens e o mapeamento de propriedades. Para mais detalhes, consulte Mapeamento de estrutura de mensagens entre MQTT e ApsaraMQ for RocketMQ.

Nota

Os programas de demonstração para diferentes linguagens de programação podem variar em completude e são atualizados periodicamente. Caso não encontre uma demonstração para um recurso específico, use o exemplo em Java como referência, baixe o SDK correspondente à sua linguagem e teste o recurso.

Configuração de credenciais de acesso

Antes de executar o código de exemplo, configure as variáveis de ambiente MQTT_AK_ENV e MQTT_SK_ENV conforme descrito abaixo:

Importante

Um AccessKey associado a uma conta Alibaba Cloud concede acesso total a todas as APIs. Se o seu AccessKey for comprometido, a segurança de todos os recursos da sua conta estará em risco. Para proteger sua conta, utilize o AccessKey de um usuário do Resource Access Management (RAM) para acesso às APIs e operações diárias de manutenção. Para saber como crie um AccessKey, consulte Criar um AccessKey.

Configuração para Linux e macOS

Crie o arquivo .bash_profile

Nota
Se esta for a primeira vez que você defina variáveis de ambiente, execute o comando touch ~/.bash_profile para criar o arquivo de configuração. Caso o arquivo já exista, edite-o com o comando vim ~/.bash_profile.
```
touch ~/.bash_profile
vim ~/.bash_profile
```

Configure o arquivo .bash_profile

# Replace <ACCESS_KEY_ID> and <ACCESS_KEY_SECRET> with your own AccessKey ID and AccessKey secret.
export MQTT_AK_ENV=<ACCESS_KEY_ID>
export MQTT_SK_ENV=<ACCESS_KEY_SECRET>

Após a edição, salve o arquivo e saia.

Aplique as alterações do arquivo .bash_profile
```
# Apply the changes in the configuration file
source ~/.bash_profile
# Verify the configuration
echo $MQTT_AK_ENV
```
Se o sistema retornar o AccessKey correto, a configuração foi concluída com sucesso.

Importante

Após configure as variáveis de ambiente, reinicie suas ferramentas de desenvolvimento (como IDEs) ou serviços relacionados para que as alterações tenham efeito.

Configuração para Windows

Using the graphical user interface (GUI)

Procedimento

Os passos a seguir descrevem como defina variáveis de ambiente no Windows 10 pela interface gráfica.

Clique em com o botão direito em This PC na área de trabalho e escolha Properties > Advanced system settings > Environment Variables. Clique em New em System variables ou User variables. Configure os seguintes parâmetros:

Variable	Example value
AccessKey ID	Variable name: MQTT_AK_ENV Variable value: LTAI****
AccessKey Secret	Variable name: MQTT_SK_ENV Variable value: EZJn****

Teste a configuração

Clique em Start (ou use o atalho Win+R), insira cmd na caixa de diálogo Run e clique em OK (ou pressione Enter) para abrir o prompt de comando. Execute os comandos echo %MQTT_AK_ENV% e echo %MQTT_SK_ENV%. Se o sistema retornar os AccessKeys corretos, a configuração foi concluída com êxito.

Use the command prompt (CMD)

Procedimento

Abra o prompt de comando como administrador e execute os comandos abaixo para adicionar as variáveis de ambiente ao sistema.
```
setx MQTT_AK_ENV LTAI**** /M
setx MQTT_SK_ENV EZJn**** /M
```
O parâmetro /M indica uma variável de sistema. Omita este parâmetro caso deseje defina uma variável de usuário.
Teste a configuração

Clique em Start (ou use o atalho Win+R), insira cmd na caixa de diálogo Run e clique em OK (ou pressione Enter) para abrir o prompt de comando. Execute os comandos echo %MQTT_AK_ENV% e echo %MQTT_SK_ENV%. Se o sistema retornar os AccessKeys corretos, a configuração foi concluída com êxito.

Use Windows PowerShell

No PowerShell, defina novas variáveis de ambiente válidas para todas as novas sessões:

[System.Environment]::SetEnvironmentVariable('MQTT_AK_ENV', 'LTAI****', [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable('MQTT_SK_ENV', 'EZJn****', [System.EnvironmentVariableTarget]::User)

Para defina variáveis de ambiente para todos os usuários (requer permissão administrativa):

[System.Environment]::SetEnvironmentVariable('MQTT_AK_ENV', 'LTAI****', [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable('MQTT_SK_ENV', 'EZJn****', [System.EnvironmentVariableTarget]::Machine)

Para defina variáveis de ambiente temporárias, válidas apenas para a sessão atual:

$env:MQTT_AK_ENV = "LTAI****"
$env:MQTT_SK_ENV = "EZJn****"

No PowerShell, execute os comandos Get-ChildItem env:MQTT_AK_ENV e Get-ChildItem env:MQTT_SK_ENV. Se o sistema retornar os AccessKeys corretos, a configuração foi concluída com êxito.

Importante

Após configure as variáveis de ambiente, reinicie suas ferramentas de desenvolvimento (como IDEs) ou serviços relacionados para que as alterações tenham efeito.

Mais informações

O código de exemplo serve apenas como referência. Para baixe o SDK de uma linguagem específica, consulte Downloads de SDKs.