O IoT Platform oferece suporte à comunicação broadcast. Você pode enviar uma mensagem de broadcast para todos os dispositivos associados a um produto. Nesse cenário, os dispositivos não precisam se inscrever em um tópico de broadcast para receber a mensagem. Também é possível transmitir uma mensagem para todos os dispositivos inscritos em um tópico específico. O dispositivo deve estar online para receber a mensagem enviada pelo servidor. Este tópico descreve como configurar o Link SDK for C para implementar a comunicação broadcast.
Pré-requisitos
-
Ao personalizar o SDK, na página SDK Customization, selecione MQTT 3.1.1 na seção Connect To IoT Platform Protocol.
Informações básicas
Para obter mais informações sobre comunicação broadcast, consulte Comunicação broadcast.
O IoT Platform fornece a operação PubBroadcast para viabilizar a comunicação broadcast. Para obter mais informações, consulte PubBroadcast.
no heading
Funcionamento
Uma aplicação estabelece conexão com o IoT Platform ao chamar as APIs do Link SDK for C com base no protocolo MQTT e, em seguida, recebe e responde às mensagens de broadcast enviadas pelo IoT Platform.
O diagrama de sequência a seguir utiliza a aplicação do dispositivodemos/mqtt_broadcast_demo.c como exemplo para ilustrar o fluxo de implementação.
Esse recurso exige uma conexão MQTT. Para obter as operações de API relacionadas, consulte aiot_mqtt_api.h.
no heading
Observações de uso
As mensagens de broadcast são enviadas apenas para dispositivos online dentro de um produto.
Ao transmitir mensagens para dispositivos online específicos por inscrição em tópico, a frequência máxima de chamada da API de broadcast é de uma vez por segundo.
Na transmissão de mensagens para todos os dispositivos online de um produto, não é necessária a inscrição em um tópico de broadcast. A frequência máxima de chamada da API de broadcast é de uma vez por minuto.
O tamanho máximo do corpo de uma mensagem de broadcast é de 64 KB.
no heading
Exemplos
Para obter um exemplo de código do recurso de conexão MQTT, consulte Exemplo.
Para obter códigos de erro relacionados ao recurso de conexão MQTT, consulte Códigos de erro comuns.