IoT Platform admite la comunicación de difusión. Puede enviar un mensaje de difusión a todos los dispositivos asociados a un producto. En este caso, los dispositivos no necesitan suscribirse a un tema de difusión para recibir el mensaje. También puede difundir un mensaje a todos los dispositivos suscritos a un tema específico. El dispositivo debe estar en línea para recibir el mensaje que envía el servidor. Este tema describe cómo configurar Link SDK for C para implementar la comunicación de difusión.
Requisitos previos
-
Al personalizar el SDK, en la página SDK Customization, seleccione MQTT 3.1.1 en la sección Connect To IoT Platform Protocol.
Información de contexto
Para obtener más información sobre la comunicación de difusión, consulte Broadcast communication.
IoT Platform proporciona la operación PubBroadcast para lograr la comunicación de difusión. Para obtener más información, consulte PubBroadcast.
no heading
Cómo funciona
Una aplicación establece una conexión con IoT Platform mediante llamadas a las API de C Link SDK basadas en la conexión con IoT Platform a través de MQTT, y luego recibe y responde a los mensajes de difusión que envía IoT Platform.
El siguiente gráfico de series temporales utiliza la aplicación del dispositivodemos/mqtt_broadcast_demo.c como ejemplo para ilustrar el flujo de implementación.
Esta función requiere una conexión MQTT. Para consultar las operaciones de API relacionadas, véase aiot_mqtt_api.h.
no heading
Notas de uso
Los mensajes de difusión se envían únicamente a los dispositivos en línea de un producto.
Al difundir mensajes a dispositivos en línea específicos mediante suscripción a temas, la frecuencia máxima de llamada a la API de difusión es de una vez por segundo.
Al difundir mensajes a todos los dispositivos en línea de un producto, estos no necesitan suscribirse a un tema de difusión. La frecuencia máxima de llamada a la API de difusión es de una vez por minuto.
El tamaño máximo del cuerpo de un mensaje de difusión es de 64 KB.
no heading
Ejemplos
Para consultar un ejemplo de código de la función de conexión MQTT, véase Example.
Para consultar los códigos de error relacionados con la función de conexión MQTT, véase Common error codes.