IoT Platform prend en charge les options d'abonnement MQTT 5.0 qui permettent de contrôler le comportement de distribution des messages, notamment les niveaux QoS, la suppression de l'écho local, la gestion de l'indicateur Retain et la distribution des messages retenus.
Description de la fonctionnalité
Configurez les options d'abonnement pour contrôler la manière dont IoT Platform gère la distribution des messages. MQTT 5.0 prend en charge les options d'abonnement suivantes :
|
Élément |
Description |
|
Le niveau de qualité de service (QoS) pour la messagerie MQTT. Les niveaux QoS dans MQTT 5.0 sont identiques à ceux de MQTT 3.1. |
|
|
Indique si un appareil reçoit les messages qu'il a lui-même publiés. |
|
|
Indique si IoT Platform conserve l'indicateur Retain lors du transfert d'un message vers un appareil. |
|
|
Indique si le serveur envoie les messages retenus à un appareil lors de l'établissement d'un abonnement. |
Si vous utilisez Link SDK for C pour connecter des appareils à IoT Platform, toutes les options d'abonnement sont définies sur 0 par défaut.
Nous vous recommandons de définir l'option No Local sur 1 afin de réduire la distribution inutile de messages.
Niveau QoS
MQTT 5.0 définit trois niveaux QoS.
|
Niveau |
Description |
Scénario |
|
QoS 0 |
Un message est distribué au plus une fois. La distribution n'est pas garantie et le message peut être perdu. |
Convient à la transmission de données de capteurs. |
|
QoS 1 |
Un message est distribué au moins une fois. La distribution est garantie. |
Convient à la transmission de commandes de contrôle à distance. |
|
QoS 2 |
Un message est distribué exactement une fois. Remarque
IoT Platform ne prend pas en charge ce niveau QoS. |
S.O. |
No Local
Dans MQTT 3.1.1, un appareil qui s'abonne à un sujet auquel il publie reçoit ses propres messages. Dans MQTT 5.0, définissez l'option No Local sur 1 afin qu'un appareil ne reçoive pas les messages qu'il a publiés lui-même.
Valeurs valides :
1 : L'appareil ne reçoit pas les messages qu'il a publiés lui-même.
0 : L'appareil reçoit les messages qu'il a publiés lui-même.
Pour les abonnements à des sujets avec caractères génériques, définissez cette option sur 1 pour simplifier les abonnements et réduire les messages inutiles. La figure suivante illustre le processus de messagerie lorsque l'option No Local est définie sur 1.
Retain As Publish
Lorsque IoT Platform transfère un message vers un appareil, spécifiez s'il faut conserver l'indicateur Retain dans le message.
Lors de la configuration de l'abonnement d'un appareil, définissez l'option Retain As Publish sur l'une des valeurs suivantes :
1 : IoT Platform conserve l'indicateur Retain dans les messages normaux transférés et dans les messages retenus qu'IoT Platform publie en tant que broker.
0 : Pour les messages normaux transférés, IoT Platform supprime l'indicateur Retain. Pour les messages retenus qu'IoT Platform publie en tant que broker, l'indicateur Retain est conservé.
Le tableau suivant montre comment l'option Retain As Publish affecte l'indicateur Retain dans les messages reçus par un appareil. L'état de l'indicateur Retain du message publié sur IoT Platform peut être :
True : Le message publié contient l'indicateur Retain. L'option Retain As Publish détermine si l'appareil reçoit l'indicateur.
False : Le message publié ne contient pas l'indicateur Retain. L'option Retain As Publish n'a aucun effet et l'appareil ne reçoit jamais l'indicateur Retain.
|
Le message publié sur IoT Platform contient-il l'indicateur Retain ? |
L'abonnement est-il établi lors de la publication du message sur IoT Platform ? |
Option Retain As Publish |
Le message reçu par l'appareil contient-il l'indicateur Retain ? |
|
True |
L'abonnement est établi et IoT Platform publie immédiatement le message. |
1 |
True |
|
0 |
False |
||
|
L'abonnement n'est pas établi et IoT Platform publie le message retenu uniquement après l'établissement d'un abonnement. |
1 |
True |
|
|
0 |
True |
||
|
False |
L'état de l'abonnement n'a aucun impact. |
Toute valeur |
False |
Un appareil reçoit un message avec l'indicateur Retain lorsque l'une des conditions suivantes est remplie :
Le message publié contient l'indicateur Retain et l'option Retain As Publish est définie sur 1.
IoT Platform publie un message retenu en tant que broker et l'option Retain As Publish est définie sur 0.
Retain Handling
L'option Retain Handling contrôle si le serveur distribue les messages retenus à un appareil après l'établissement d'un abonnement.
Valeurs valides :
0 : Le serveur distribue les messages retenus à l'appareil chaque fois qu'il s'abonne à un sujet.
1 : Le serveur distribue les messages retenus uniquement lors du premier abonnement à un sujet. Si un appareil se réabonne au même sujet au cours d'une session, les messages retenus ne sont pas envoyés à nouveau.
2 : Le serveur ne distribue pas les messages retenus, quel que soit l'état de l'abonnement.