原文:http://www.eclipse.org/paho/files/mqttdoc/MQTTClient/html/index.html
最近在使用Paho的MQTT客戶端,由於英語看着有點慢,因此將其翻譯為中文,與大家共享。由於英語水平有限,如有翻譯不對之處,請幫忙指出。
MQTT客戶端C語言庫
MQTT客戶端的C語言庫.© Copyright IBM Corp. 2009, 2017.
這些頁面描述了早期的通常被認為更容易使用同步API.(同步API)一些調用將會阻塞。對於新的完全異步的無阻塞API,尤其適合在視窗化的環境中使用(可參見MQTT C Client Asynchronous API Documentation)。
MQTT客戶端程序連接到具有MQTT功能的服務器。典型的客戶端負責從遙測設備收集信息並將信息發布到服務器。它還可以訂閱主題, 接收消息, 並使用這些信息來控制遙測設備。
MQTT客戶實現了已發布的MQTT v3協議。您可以使用您選擇的編程語言和平台編寫自己的MQTT協議API。這可能會很費時且容易出錯。使用此庫只需要很少的代碼就可以寫出功能齊全的mqtt客戶端應用程序。這里提供的信息記錄了MQTT客戶端C語言庫提供的API。
使用客戶端
使用客戶端庫的應用程序通常使用類似的結構:
1.創建一個客戶端對象;
2.設置連接MQTT服務器的選項;
3.如果多線程(異步模式)操作被使用則設置回調函數(詳見 Asynchronous vs synchronous client applications);
4.訂閱客戶端需要接收的任意話題;
5.重復以下操作直到結束:
a.發布客戶端需要的任意信息;
b.處理所有接收到的信息;
6.斷開客戶端連接;
7.釋放客戶端使用的所有內存。
下面展示了一些簡單的示例: