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旗標集的新訊息會取代先前傳送至主題的任何現有保留訊息。

  NOTE：您無法發佈至具有RETAIN旗標集的預留主題。

• 訂閱保留訊息主題

  用戶端訂閱保留的訊息主題，就像訂閱任何其他MQTT訊息主題一樣。訂閱保留訊息主題收到的保留訊息具有RETAIN旗標集。

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

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

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

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

• 擷取保留訊息

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

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

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

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

• 列出保留訊息主題

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

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

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

• 保留「Will」訊息

  MQTT 裝置連線時建立的訊息是否可以透過在 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 測試用戶端

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

  有些非預期的結果可能是保留訊息在 中實作方式的這些層面的結果 AWS IoT Core。

  • 保留訊息限制

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

  • 保留訊息的傳遞順序

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

• $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 不支援 3 MQTT 的下列封包：PUBREC、 PUBREL和 PUBCOMP。

• AWS IoT 不支援 5 MQTT 的下列封包：PUBREC、PUBCOMP、 PUBREL和 AUTH。

• 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。此訊息包含了一個旗標，指出連線是否會恢復先前的工作階段。

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

• 當用戶端訂閱主題時，訊息代理程式傳送 的時間SUBACK與用戶端開始接收新的相符訊息的時間之間可能會有延遲。

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

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

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

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

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

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

• 不支援此MQTTDUP旗標。