C# ve .NET MQTT 3.1.1 ve 5.0

MQTT 3.1.1 ve 5.0 için C# MQTT İstemcisi

.NET Framework 2.0'dan .NET 10'a, bu .NET MQTT istemcisiyle C# uygulamalarını TCP ya da WebSocket üzerinden herhangi bir MQTT aracısına bağlayın.

MQTT 3.1.1 ve MQTT 5.0
QoS 0, 1 ve 2
TCP ya da WebSocket üzerinden TLS
Last will, retain, keep-alive

C#'ta bağlanın, abone olun ve yayınlayın → · Fiyatlandırmaya bakın →

C# MQTT istemcisi
using esegece.sgcWebSockets;

var client = new TsgcWebSocketClient();
client.Host = "broker.example.com";
client.Port = 8883;
client.TLS = true;
client.Specifications.RFC6455 = false; // MQTT over TCP

var mqtt = new TsgcWSPClient_MQTT();
mqtt.Client = client;
mqtt.MQTTVersion = TwsMQTTVersion.mqtt5;

mqtt.OnMQTTConnect += (conn, session, code, reason, props) =>
    mqtt.Subscribe("sensors/#");
mqtt.OnMQTTPublish += (conn, topic, text, props) =>
    Console.WriteLine(topic + ": " + text);

client.Active = true;

sgcWebSockets istemcisinin üzerinde çalışan bir MQTT istemcisi

Bir taşıma bileşeni, bir protokol bileşeni, her MQTT paketi için olaylar.

sgcWebSockets .NET içindeki C# MQTT istemcisi, esegece.sgcWebSockets ad alanındaki TsgcWSPClient_MQTT bileşenidir. Kendisi soket açmaz. Client özelliğine bir TsgcWebSocketClient atarsınız ve bu istemci MQTT paketlerini ya düz bir TCP akışı olarak (1883 ve 8883 numaralı bağlantı noktaları) ya da WebSocket üzerinden MQTT uç noktası sunan aracılar için WebSocket çerçeveleri içinde taşır. Ana makine, bağlantı noktası, TLS, proxy ve otomatik yeniden bağlanma taşımada kalır, MQTT oturumu, konular ve QoS ise protokol bileşeninde bulunur.

Aracıdan gelen her yanıt bir C# olayına dönüşür: OnMQTTConnect, OnMQTTPublish, OnMQTTSubscribe, OnMQTTPubAck, OnMQTTPubRec, OnMQTTPubComp, OnMQTTPing ve OnMQTTDisconnect, ayrıca MQTT 5.0 gelişmiş kimlik doğrulaması için OnMQTTAuth. Aynı paket Windows, Linux ve macOS'ta .NET Framework 2.0'dan 4.8.1'e, .NET Core 1.0'dan 3.1'e, .NET 5'ten .NET 10'a ve .NET Standard 1.6 ile 2.0 hedefler.

MQTT 3.1.1 ve 5.0

Protokolü MQTTVersion ile seçin: TwsMQTTVersion.mqtt311 ya da TwsMQTTVersion.mqtt5.

TCP ya da WebSocket

Taşımada Specifications.RFC6455 = false ham MQTT'yi TCP üzerinden gönderir; MQTT'yi bir WebSocket yolundan tünellemek için açık bırakın.

Üç QoS düzeyi

Her yayın ve abonelikte TmqttQoS.mtqsAtMostOnce, mtqsAtLeastOnce ve mtqsExactlyOnce.

Oturum denetimi

Authentication içinde kullanıcı adı ve parola, HeartBeat içinde keep-alive ping'leri, LastWillTestament içinde bir last will.

C#'ta bağlanın, abone olun ve yayınlayın

esegece.sgcWebSockets NuGet paketini (ya da esegece.sgcWebSockets.Community) kurun, ardından dört adımı izleyin.

using esegece.sgcWebSockets;

// transport: TCP with TLS on the standard secure MQTT port
var client = new TsgcWebSocketClient();
client.Host = "broker.example.com";
client.Port = 8883;
client.TLS = true;
client.TLSOptions.Version = TwsTLSVersions.tls1_2;
client.Specifications.RFC6455 = false;   // raw MQTT, no WebSocket handshake

// protocol: MQTT 3.1.1 with credentials and keep-alive
var mqtt = new TsgcWSPClient_MQTT();
mqtt.Client = client;
mqtt.MQTTVersion = TwsMQTTVersion.mqtt311;
mqtt.Authentication.Enabled = true;
mqtt.Authentication.UserName = "device-01";
mqtt.Authentication.Password = "secret";
mqtt.HeartBeat.Enabled = true;
mqtt.HeartBeat.Interval = 30;

mqtt.OnMQTTConnect += (conn, session, reasonCode, reasonName, props) =>
    Console.WriteLine("#mqtt connected: " + reasonName);
mqtt.OnMQTTDisconnect += (conn, reasonCode, reasonName, props) =>
    Console.WriteLine("#mqtt disconnected: " + reasonName);

client.Active = true;
// subscribe once the broker has accepted the session
mqtt.OnMQTTConnect += (conn, session, reasonCode, reasonName, props) =>
{
    mqtt.Subscribe("sensors/+/temperature");
    mqtt.Subscribe("alerts/#", TmqttQoS.mtqsExactlyOnce, null);
};

mqtt.OnMQTTSubscribe += (conn, packetId, codes, props) =>
    Console.WriteLine("#subscribed, packet " + packetId);

// every message on a subscribed topic arrives here
mqtt.OnMQTTPublish += (conn, topic, text, props) =>
    Console.WriteLine(topic + " = " + text);

// stop receiving a topic
mqtt.UnSubscribe("alerts/#");
// QoS 0: fire and forget
mqtt.Publish("sensors/room1/temperature", "21.5");

// QoS 1 with the retain flag, so late subscribers get the last value
mqtt.Publish("devices/device-01/status", "online", TmqttQoS.mtqsAtLeastOnce, true);

// QoS 2: wait up to 10 seconds for the broker to confirm
bool ok = mqtt.PublishAndWait("orders/new", "{\"id\": 42}", TmqttQoS.mtqsExactlyOnce, 10000);

// binary payloads
mqtt.Publish("images/cam1", File.ReadAllBytes("frame.jpg"));

// acknowledgements
mqtt.OnMQTTPubAck  += (conn, packetId, reasonCode, reasonName, props) =>
    Console.WriteLine("#puback " + packetId);
mqtt.OnMQTTPubComp += (conn, packetId, reasonCode, reasonName, props) =>
    Console.WriteLine("#pubcomp " + packetId);
using esegece.sgcWebSockets;

// the same MQTT client, tunnelled through a secure WebSocket (wss://)
var client = new TsgcWebSocketClient();
client.Host = "broker.example.com";
client.Port = 443;
client.TLS = true;
client.Options.Parameters = "/mqtt";   // the broker's WebSocket path
client.WatchDog.Enabled = true;          // reconnect after network drops

var mqtt = new TsgcWSPClient_MQTT();
mqtt.Client = client;
mqtt.OnMQTTPublish += (conn, topic, text, props) => Console.WriteLine(topic + ": " + text);

client.Active = true;

.NET indirmesindeki WinForms demoları MQTT Client ve MQTT Console, aynı çağrıları bir aracı listesi, TLS ve proxy ayarları, QoS ve retain seçenekleriyle bir forma bağlar.

C#'ta MQTT QoS 0, 1 ve 2

Publish, PublishAndWait ya da Subscribe yöntemine bir TmqttQoS değeri geçirin. QoS 1 ve 2'de istemci, onay zamanında gelmediğinde iletiyi yeniden gönderir. Teslimatı izlemek için OnMQTTPubAck ya da OnMQTTPubComp olayını işleyin ya da aracı zaman aşımı içinde yanıt vermediğinde (varsayılan olarak 10 saniye) false döndüren PublishAndWait yöntemini çağırın.

QoSC# değeriTeslimatOnay olayı
0TmqttQoS.mtqsAtMostOnceEn fazla bir kez, en iyi çaba, yanıt yokyok
1TmqttQoS.mtqsAtLeastOnceEn az bir kez, aracı tarafından onaylanırOnMQTTPubAck
2TmqttQoS.mtqsExactlyOnceTam bir kez, dört adımlı el sıkışmaOnMQTTPubRec, OnMQTTPubComp

TLS, kimlik bilgileri, last will ve keep-alive

8883 numaralı bağlantı noktasında TLS

Taşımada TLS = true ayarlayın ve protokolü TLSOptions.Version içinde TLS 1.3'e kadar seçin. İstemci sertifikası isteyen aracılar için TLSOptions ayrıca CertFile, KeyFile, Password ve RootCertFile alır, VerifyCertificate ise sunucu sertifikasını denetler.

Kullanıcı adı ve parola

Authentication.Enabled, Authentication.UserName ve Authentication.Password CONNECT paketine girer.

Last will

LastWillTestament, Topic, Text, QoS ve Retain değerlerini ayarlar, böylece bir cihaz temiz bir bağlantı kesme olmadan düştüğünde aracı bir "offline" iletisi yayınlar.

Keep-alive

HeartBeat.Enabled ve HeartBeat.Interval PINGREQ paketleri gönderir; OnMQTTPing her yanıtı bildirir ve Ping() isteğe bağlı bir tane gönderir.

İstemci kimliği ve temiz oturum

OnMQTTBeforeConnect, CleanSession ve ClientIdentifier değerlerini başvuruyla geçirir, böylece cihaz başına kalıcı bir oturum ve sabit bir istemci kimliği seçersiniz.

Proxy ve yeniden bağlanma

Taşımanın Proxy ayarları ve WatchDog otomatik yeniden bağlanması MQTT için değişmeden geçerlidir.

mqtt.LastWillTestament.Enabled = true;
mqtt.LastWillTestament.Topic = "devices/device-01/status";
mqtt.LastWillTestament.Text = "offline";
mqtt.LastWillTestament.QoS = TmqttQoS.mtqsAtLeastOnce;
mqtt.LastWillTestament.Retain = true;

mqtt.OnMQTTBeforeConnect += (TsgcWSConnection conn, ref bool cleanSession, ref string clientId) =>
{
    cleanSession = false;
    clientId = "device-01";
};

C#'ta MQTT 5.0 özellikleri

MQTTVersion = TwsMQTTVersion.mqtt5 ayarlayın ve istemci MQTT 5.0 konuşur. Her onay olayı bundan sonra aracının ReasonCode ve ReasonName değerlerini paket özellikleriyle birlikte taşır, böylece hatalar kopan bir bağlantı yerine bir nedenle gelir.

Bağlantı özellikleri

ConnectProperties, SessionExpiryInterval, ReceiveMaximum, MaximumPacketSize, TopicAliasMaximum, UserProperties ve yanıt ile sorun bilgisi için istek bayraklarını ayarlar.

Yayın özellikleri

İstek ve yanıt kalıpları için ileti başına ContentType, ResponseTopic, CorrelationData, MessageExpiryInterval, TopicAlias, PayloadFormat ve kullanıcı özellikleri.

Gelişmiş kimlik doğrulama

Auth() bir AuthenticationMethod ve AuthenticationData ile, yeniden kimlik doğrulama dahil, AUTH paketleri gönderir ve OnMQTTAuth aracının sınamasını alır.

Will ve bağlantı kesme özellikleri

Last will üzerinde bir will gecikme aralığı ve ileti süre sonu, ayrıca Disconnect üzerinde bir neden kodu, neden dizesi ve oturum süre sonu.

mqtt.MQTTVersion = TwsMQTTVersion.mqtt5;
mqtt.ConnectProperties.Enabled = true;
mqtt.ConnectProperties.SessionExpiryInterval = 3600;   // keep the session one hour
mqtt.ConnectProperties.ReceiveMaximum = 100;

mqtt.OnMQTTConnect += (conn, session, reasonCode, reasonName, props) =>
    Console.WriteLine("CONNACK " + reasonCode + " " + reasonName);

Herhangi bir standart MQTT aracısı, ayrıca AWS IoT ve Azure IoT

İstemci MQTT 3.1.1 ve 5.0 belirtimlerini izlediği için, kendi barındırdığınız ve yönetilen aracılara aynı şekilde bağlanır: düz TCP için 1883, TLS için 8883 numaralı bağlantı noktasında ya da yalnızca HTTPS bağlantı noktaları açıkken aracının WebSocket yolunda. Bulut IoT platformları için sgcWebSockets .NET ayrıca AWS IoT Core için bir AWS IoT istemcisi ve Azure IoT Hub için bir Azure IoT istemcisi sunar, ikisi de MQTT tabanlıdır ve .NET özellik matrisinde listelenir.

Aynı kitaplık ayrıca AMQP 0.9.1 ve 1.0, STOMP, Kafka ve C# WebSocket istemcisi ve sunucusu sağlar, böylece tek bir bağımlılık uygulamadaki her mesajlaşma protokolünü kapsar.

Başlamak ücretsiz, her protokol için tek fiyat

MQTT istemcisi her .NET sürümünde bulunur. Community, küçük ekiplerin (1 milyon EUR gelirin altında, en fazla 5 geliştirici) ticari ve ticari olmayan kullanımı için ücretsizdir, tam özellik kümesi ve bir başlangıç bildirimiyle. Professional bildirimi kaldırır ve geliştirici başına €149 fiyatından 1 yıl güncellemeyle başlar; Enterprise derlemeleri yeniden oluşturmak için kaynak kodunu ekler. Team ve Site lisansları fiyatlandırma sayfasında (.NET sekmesi).

C# MQTT soruları

Aracının Host ve Port değerleriyle bir TsgcWebSocketClient oluşturun, düz TCP aracısı için Specifications.RFC6455 = false ayarlayın, bir TsgcWSPClient_MQTT oluşturun ve istemciyi Client özelliğine atayın. client.Active = true ayarı bağlantıyı açar ve aracı oturumu kabul ettiğinde OnMQTTConnect tetiklenir.

Evet. MQTT 5.0 için MQTTVersion değerini TwsMQTTVersion.mqtt5, MQTT 3.1.1 için TwsMQTTVersion.mqtt311 yapın. MQTT 5.0 her onayda neden kodları, bağlantı ve yayın özellikleri, kullanıcı özellikleri ve gelişmiş kimlik doğrulama ekler.

Publish(topic, text, TmqttQoS.mtqsAtLeastOnce) ya da TmqttQoS.mtqsExactlyOnce çağırın, isteğe bağlı olarak bir retain bayrağıyla. Kodun aracının iletiyi işlediğini bilmesi gerekiyorsa PublishAndWait kullanın: zaman aşımı içinde yanıt gelmezse false döndürür.

Evet. TsgcWebSocketClient üzerinde Port = 8883 ve TLS = true ayarlayın, sürümü TLSOptions.Version içinde (TLS 1.3'e kadar) seçin ve aracı bir istemci sertifikası istiyorsa TLSOptions.CertFile ve KeyFile ekleyin.

Evet, taşımanın varsayılanı budur. Specifications.RFC6455 değerini açık bırakın, Options.Parameters değerini aracının WebSocket yoluna (örneğin /mqtt) ayarlayın ve wss:// için 443 numaralı bağlantı noktasında TLS = true kullanın. Bu, MQTT'yi yalnızca HTTPS'ye izin veren güvenlik duvarlarından geçirir.

Windows, Linux ve macOS'ta .NET Framework 2.0'dan 4.8.1'e, .NET Core 1.0'dan 3.1'e, .NET 5'ten .NET 10'a ve .NET Standard 1.6 ile 2.0. nuget.org'dan esegece.sgcWebSockets ya da ücretsiz esegece.sgcWebSockets.Community paketini kurun.

Evet. Community sürümü MQTT istemcisini içerir ve küçük ekiplerin (1 milyon EUR gelirin altında, en fazla 5 geliştirici) ticari ve ticari olmayan kullanımı için bir başlangıç bildirimiyle ücretsizdir. Daha büyük kuruluşlar geliştirici başına €149 fiyatından Professional ya da Enterprise satın alır.

sgcWebSockets .NET hakkında daha fazlası

C# WebSocket kitaplığı

MQTT trafiğini taşıyan WebSocket istemcisi ve sunucusu, TLS, sıkıştırma ve otomatik yeniden bağlanmayla.

.NET özellik matrisi

.NET sürümlerindeki her bileşen ve protokol, MQTT, AMQP, STOMP, AWS IoT ve Azure IoT dahil.

İndirme

Community sürümü, NuGet paketleri ve MQTT Client ile MQTT Console'un da aralarında bulunduğu derlenmiş .NET demoları.

Delphi ve C++Builder için de

Aynı MQTT istemcisi, aynı TsgcWSPClient_MQTT sınıfı ve olaylarıyla Delphi ve C++Builder için de mevcuttur.

En avantajlı seçenek: All-AccessTüm eSeGeCe ürünleri, Premium Destek dahil, yılda €1,059'dan itibaren.
All-Access fiyatlarına bakın

İlk MQTT iletinizi bugün C#'tan yayınlayın

Deneme sürümünü indirin ya da NuGet'ten esegece.sgcWebSockets.Community paketini kurun. Professional geliştirici başına €149 fiyatından.