MQTT

• 當持久性工作階段過期時間經過時。當訊息代理程式偵測到用戶端已中斷連線時 (包括用戶端中斷連線或連線逾時)，持久性工作階段過期計時器將會啟動。

• 用戶端傳送將 cleanSession 旗標設定為 1 的 CONNECT 訊息。

• 如果目前工作階段的過期間隔為 0，則無法將 DISCONNECT 封包上的工作階段過期間隔設定為大於 0。

• 如果目前工作階段的過期間隔大於 0，且您將 DISCONNECT 封包上的工作階段過期間隔設為 0，則工作階段將於 DISCONNECT 結束。

• 否則，DISCONNECT 上的工作階段過期間隔會更新目前工作階段的過期間隔。

使用 MQTT 保留訊息的範例

• 作為初始組態訊息

  MQTT 保留訊息會在用戶端訂閱主題後傳送至用戶端。如果您希望所有訂閱主題的用戶端在訂閱後立即收到 MQTT 保留訊息，您可以發佈設定 RETAIN 旗標的組態訊息。只要發佈新的組態訊息，訂閱用戶端也會收到該組態的更新。

• 作為最後一個已知的狀態訊息

  裝置可以在目前狀態訊息上設定 RETAIN 旗標，以便 AWS IoT Core 將其儲存起來。當應用程式連線或重新連線時，他們可以訂閱此主題，並在訂閱保留的訊息主題後立即取得上次回報的狀態。透過這種方式，可以避免等到來自裝置的下一個訊息才能查看目前狀態。

• 建立保留訊息

  用戶端會決定當其發佈 MQTT 訊息時是否保留訊息。用戶端可以在使用裝置 SDK 發佈訊息時設定 RETAIN 旗標。應用程式和服務可以在使用 Publish 動作發佈 MQTT 訊息時設定 RETAIN 旗標。

  每個主題名稱只會保留一則訊息。已設定 RETAIN 旗標並發佈至主題的新訊息，會取代先前傳送至主題的任何現有保留訊息。

  請注意：您無法發佈至已設定 RETAIN 旗標的預留主題。

• 訂閱保留訊息主題

  用戶端會訂閱保留訊息主題，如同訂閱其他任何 MQTT 訊息主題一樣。透過訂閱保留訊息主題而接收的保留訊息已設定 RETAIN 旗標。

  AWS IoT Core 當用戶端將具有 0 位元組訊息承載的保留訊息發佈至保留的訊息主題時，會從中刪除保留的訊息。訂閱保留訊息主題的用戶端也會收到 0 個位元組訊息。

  訂閱內含保留訊息主題的萬用字元主題篩選條件，可讓用戶端接收向保留訊息主題發佈的後續訊息，但不會在訂閱時即傳遞保留訊息。

  請注意：若要在訂閱時即收到保留訊息，訂閱要求中的主題篩選條件必須完全符合保留訊息主題。

  訂閱保留訊息主題時接收的保留訊息已設定 RETAIN 旗標。訂閱用戶端在訂閱後接收的保留訊息未設定 RETAIN 旗標。

• 擷取保留訊息

  當用戶端訂閱帶有保留訊息的主題時，系統就會自動將保留訊息傳遞給用戶端。若要讓用戶端在訂閱時即接收保留訊息，則必須訂閱保留訊息的確切主題名稱。訂閱內含保留訊息主題的萬用字元主題篩選條件，可讓用戶端接收向保留訊息主題發佈的後續訊息，但不會在訂閱時即傳遞保留訊息。

  服務和應用程式可以透過呼叫 ListRetainedMessages 和 GetRetainedMessage 來列出和擷取保留訊息。

  在未設定 RETAIN 旗標的情況下，無法防止用戶端將訊息發佈至保留訊息主題。這可能會導致非預期的結果，例如保留訊息與訂閱主題接收到的訊息不相符。

  使用 MQTT 5 時，如果保留的訊息已設定訊息過期間隔，且保留的訊息已經過期，則該主題的新訂閱者在訂閱成功後將不會收到保留的訊息。

• 列出保留訊息主題

  您可以透過呼叫 ListRetainedMessages 列出保留訊息，且可以在 AWS IoT 主控台中檢視保留訊息。

• 取得保留訊息的詳細資訊

  您可以透過呼叫 GetRetainedMessage 取得保留訊息的詳細資訊，且可以在 AWS IoT 主控台中檢視這些資訊。

• 保留「Will」訊息

  裝置連線時建立的 MQTT Will 訊息，可以藉由在 Connect Flag bits 欄位中設定 Will Retain 旗標來加以保留。

• 刪除保留訊息

  裝置、應用程式和服務可以透過將已設定 RETAIN 旗標的訊息和空白 (0 個位元組) 訊息承載發佈至要刪除的保留訊息主題名稱，以此刪除保留訊息。這類郵件會從中刪除保留的郵件 AWS IoT Core，會傳送至訂閱主題的用戶端，但不會由保留 AWS IoT Core。

  您也可以透過在 AWS IoT 主控台中存取保留訊息，來刪除保留訊息。使用 AWS IoT 主控台刪除的保留訊息，也會將 0 個位元組的訊息傳送給已訂閱保留訊息主題的用戶端。

  保留訊息遭刪除後即無法還原。用戶端需要發佈新的保留訊息，以取代已刪除的訊息。

• 對保留訊息進行偵錯和疑難排解

  此 AWS IoT 主控台提供多種工具，可協助您針對保留訊息進行疑難排解：

  • Retained messages (保留訊息) 頁面

    AWS IoT 主控台中的 Retained messages (保留訊息) 頁面會提供分頁清單，列出由您帳戶在目前區域存放的保留訊息。在此頁面上，您可以：

    • 查看每則保留訊息的詳細資訊，例如訊息承載、QoS，以及保留訊息的接收時間。

    • 更新保留訊息的內容。

    • 刪除保留訊息。

  • MQTT test client (MQTT 測試用戶端)

    AWS IoT 主控台中的 MQTT test client (MQTT 測試用戶端) 頁面可以訂閱和發佈至 MQTT 主題。發佈選項可讓您在發佈的訊息上設定 RETAIN 旗標，以模擬裝置可能出現的行為。

  某些非預期的結果可能是中如何實作保留訊息的這些方面所造成的 AWS IoT Core。

  • 保留訊息限制

    當帳戶儲存保留的訊息數目上限時，會傳回限制 AWS IoT Core 回應以 RETAIN set 發佈的訊息，且承載大於 0 位元組為止，直到刪除某些保留訊息且保留的訊息計數低於限制為止。

  • 保留訊息的傳遞順序

    我們不能保證保留訊息和訂閱訊息的傳遞順序。

• $share 是個常值字串，表示共享訂閱的主題篩選條件，必須以 $share 開頭。

• {ShareName} 是個字元字串，用來指定一組訂閱用戶使用的共享名稱。共享訂閱的主題篩選條件必須包含 ShareName，且後面接著 / 字元。{ShareName} 不得包含下列字元：/、+、或 #。{ShareName} 的大小上限為 128 個位元組。

• {TopicFilter} 會遵循與非共享訂閱相同的主題篩選條件語法。{TopicFilter} 的大小上限為 256 個位元組。

• $share/{ShareName}/{TopicFilter} 所需的兩個斜線 (/) 不包含於主題和主題篩選條件中最大斜線數目限制中。

• 當發佈至 QoS0 訂閱用戶的嘗試失敗時，不會發生重試嘗試，且會捨棄該訊息。

• 當對具有全新工作階段的 QoS1 訂閱用戶嘗試發佈失敗時，該訊息將會傳送至群組中的另一個訂閱用戶以進行多次重試。在所有重試嘗試之後無法傳遞的訊息將遭捨棄。

• 當對具有持續性工作階段的 QoS1 訂閱用戶嘗試發佈因為訂閱用戶離線而失敗時，該訊息將不會排入佇列，且會嘗試傳送至群組中的另一個訂閱用戶。在所有重試嘗試之後無法傳遞的訊息將遭捨棄。

• 共享訂閱不會收到保留的訊息。

• 當共享訂閱包含萬用字元 (# 或 +) 時，可能會有多個與主題相符的共享訂閱。若發生這種情況，訊息代理程式會複製發佈訊息，並將其傳送至每個相符之共享訂閱中的隨機用戶端。共享訂閱的萬用字元行為可說明於下圖中。

  

  於此範例中，有三個與發佈 MQTT 主題 sports/tennis 相符的共享訂閱。訊息代理程式會複製已發佈的訊息，並將該訊息傳送至每個相符群組中的隨機用戶端。

  用戶端 1 和用戶端 2 共享訂閱：$share/consumer1/sports/tennis

  用戶端 3 和用戶端 4 共享訂閱：$share/consumer1/sports/#

  用戶端 5 和用戶端 6 共享訂閱：$share/consumer2/sports/tennis

• AWS IoT 不支援 MQTT 3 的下列封包：發生錯誤、公開和發佈。

• AWS IoT 不支持 MQTT 5 的以下數據包：發布，發布，發布版本和身份驗證。

• AWS IoT 不支援 MQTT 5 伺服器重新導向。

• AWS IoT 僅支援 MQTT 服務品質 (QoS) 等級 0 和 1 級。 AWS IoT 不支援使用 QoS 層級 2 進行發佈或訂閱。請求 QoS 2 時，訊息代理程式不會傳送 PUBACK 或 SUBACK。

• 在中 AWS IoT，訂閱 QoS 層級為 0 的主題表示郵件會傳遞零次或多次。一則訊息可能會傳送超過一次。傳送超過一次的訊息在發送時可能會使用不同的封包 ID。在這些情況下，DUP 旗標就不會設置。

• 在回應連線請求時，訊息代理程式會傳送 CONNACK 訊息。此訊息包含了一個旗標，指出連線是否會恢復先前的工作階段。

• 在傳送額外的控制封包或中斷連線請求之前，用戶端必須等待其裝置從 AWS IoT 訊息代理程式接收 CONNACK 訊息。

• 當用戶端訂閱主題，訊息代理程式傳送 SUBACK 以及用戶端開始接收符合的新訊息這段期間可能會發生延遲。

• 當用戶端在主題篩選條件中使用萬用字元 # 以訂閱主題時，主題階層中位於及低於其層級的所有字串都會相符。不過，父系主題不相符。例如，訂閱主題 sensor/# 會收到向主題 sensor/、sensor/temperature、sensor/temperature/room1 發佈的訊息，但不會收到向 sensor 發佈的訊息。如需萬用字元的詳細使用資訊，請參閱 主題篩選條件。

• 訊息代理程式使用用戶端 ID 來識別每一個用戶端。用戶端 ID 作為 MQTT 承載的一部分從用戶端傳遞至訊息代理程式。具有相同用戶端 ID 的兩個用戶端，不能同時連線至訊息代理程式。當用戶端使用另一個用戶端正在使用的用戶端 ID 連線至訊息代理程式，系統會接受新的用戶端連線，而先前連線的用戶端會中斷連線。

• 在極少數情況下，訊息代理程式可能會以不同的封包 ID 重新傳送相同的邏輯 PUBLISH 訊息。

• 包含萬用字元的主題篩選條件訂閱無法接收保留訊息。若要接收保留訊息，訂閱請求必須包含與保留訊息主題完全相符的主題篩選條件。

• 訊息代理程式不保證接收訊息及 ACK 的順序。

• AWS IoT 可能有與規格不同的限制。如需詳細資訊，請參閱AWS IoT 參考指南中的 AWS IoT Core 訊息代理程式和通訊協定限制和配額。

• 不支援 MQTT DUP 旗標。