Bambu Lab MQTT，用白話說明

連線

印表機本身就是伺服器：App 透過你的網路直接連線到它，不經過 Bambu Lab 的雲端。

回報：印表機傳送的內容

連線之後，App 會先要求一次完整回報（pushall 請求），之後就會在狀態改變時收到更新，列印期間大約每秒一次。回報採用 JSON 格式，內容包括列印工作及其階段、進度和層數、剩餘時間、噴嘴、熱床和腔體溫度、風扇、AMS 槽位及其中的線材，以及印表機錯誤（HMS 代碼）。

Bambu Bar 會把這些變更合併成一份完整的印表機狀態，也就是選單列、視窗和小工具所顯示的內容。不同機型回報的欄位不同，所以 A1 不會顯示腔體溫度，而 H2D 會顯示兩個噴嘴。

請求：App 傳送的內容

指令會傳送到請求主題：暫停、繼續、停止、列印速度、腔體照明，或要求一次完整回報。要不要接受由印表機決定：在目前的韌體上，只有印表機處於僅區域網路模式並開啟開發者模式時，第三方 App 才能傳送列印指令。否則 Bambu Bar 會在這些按鈕上顯示鎖頭圖示。請參閱控制功能為什麼被鎖定。

憑證：確認那是你的印表機

連線以 TLS 加密，每台印表機都會出示一份憑證。只有當憑證能追溯到 Bambu Lab 自己的憑證授權單位（隨 App 一起提供），而且是核發給這台印表機的序號時，Bambu Bar 才會接受這台印表機。這樣一來，你網路上的其他裝置就無法冒充印表機來騙取存取碼。

裝置探索與攝影機

• 裝置探索：印表機會透過 UDP（2021 連接埠）在你的網路上廣播自己。App 就是這樣在不知道 IP 位址的情況下列出印表機，Bambu Bar 也是這樣發現印表機換了新位址。
• 攝影機不走 MQTT：X1、H2、H3C、P2S 和 X2D 印表機透過 RTSPS 串流（322 連接埠，需開啟 LAN Only Liveview），P1、A1 和 A2L 印表機則透過加密的 JPEG 串流（6000 連接埠）。請參閱在 Mac 上看攝影機。

自己查看回報內容

如需診斷，任何 MQTT 用戶端都能讀取這些回報。使用 Mosquitto 的命令列工具，並把預留位置換成你印表機的值：

mosquitto_sub -h <printer-ip> -p 8883 -u bblp -P <access-code> --insecure -t "device/<serial>/report"

--insecure 會略過憑證檢查，所以只能在你信任的網路上使用，而且只用來讀取。絕對不要把存取碼或序號貼到論壇或錯誤回報中。

不是公開的 API

這是 Bambu Lab 自家 App 在區域網路上使用的通訊協定，而不是有文件記載、穩定的 API：欄位會因機型和韌體版本而不同，Bambu Lab 也可能改變印表機接受的內容。Bambu Bar 會持續追蹤這些變化，你不必操心。相關的印表機設定請參閱區域網路模式說明，另請參閱存取碼在哪裡。