TsgcWSPClient_MQTT › Eventi › OnMQTTSubscribe

OnMQTTSubscribe Event

Si attiva quando viene ricevuto un SUBACK in risposta a Subscribe; espone i codici di risposta per topic e SubscribeProperties di MQTT 5.

Sintassi

property OnMQTTSubscribe: TsgcWSMQTTSubscribeEvent;
// TsgcWSMQTTSubscribeEvent = procedure(Connection: TsgcWSConnection; aPacketIdentifier: Word; aCodes: TsgcWSSUBACKS; SubscribeProperties: TsgcWSMQTTSUBACKProperties) of object

Valore predefinito

—

Note

Generato quando il broker risponde con un SUBACK a una richiesta SUBSCRIBE. Il broker può accettare, accettare parzialmente o rifiutare i singoli filtri di argomento nella richiesta, quindi l'evento fornisce un codice per ogni filtro. Parametri:

• aPacketIdentifier — id pacchetto a 16 bit della SUBSCRIBE originale.
• aCodes — un array TsgcWSSUBACKS con una voce per ogni filtro topic. I valori 0x00/0x01/0x02 indicano che la sottoscrizione è stata accettata con il QoS massimo concesso; i valori 0x80 e superiori (MQTT 5 aggiunge anche 0x83, 0x87, 0x8F, 0x91, 0x97, 0x9E, 0xA1, 0xA2) indicano che il filtro è stato rifiutato. Esaminare ogni codice per verificare quali filtri hanno avuto successo.
• SubscribeProperties (MQTT 5) — ReasonString e UserProperties restituiti dal broker.

Esempio

procedure TForm1.MQTTSubscribe(Connection: TsgcWSConnection;
  aPacketIdentifier: Word; aCodes: TsgcWSSUBACKS;
  SubscribeProperties: TsgcWSMQTTSUBACKProperties);
var
  i: Integer;
begin
  for i := 0 to Length(aCodes) - 1 do
    if aCodes[i] < $80 then
      Memo1.Lines.Add(Format('subscription %d accepted (QoS %d)',
        [i, aCodes[i]]))
    else
      Memo1.Lines.Add(Format('subscription %d rejected (code $%x)',
        [i, aCodes[i]]));
end;

Torna agli Eventi