{
 "byKey": {
  "cover": [
   { "say": "大家好,歡迎回到從無到有打造 A I 機器人。上一章我們認識了 R O S 二的全貌,這一章要進入核心:node、topic、服務和動作,還有一個很容易踩雷的主題,QoS。", "item": 0 }
  ],
  "原理:話題、服務、動作與 QoS 的設計取捨#1": [
   { "say": "我們先用生活的例子,來分辨三種通訊方式。", "item": 0 },
   { "say": "topic 像電台廣播。電台持續播送,收音機開了就聽,沒開就錯過,電台不在乎你有沒有聽。", "item": 1 },
   { "say": "服務像去櫃台辦事。你遞出申請書,櫃台處理完把結果交給你,你在旁邊等。", "item": 1 },
   { "say": "動作像叫外送。下單後系統接單,持續回報備餐中、配送中,你可以中途取消,最後送達或失敗。三種方式,剛好對應三類需求。", "item": 1 }
  ],
  "原理:話題、服務、動作與 QoS 的設計取捨#2": [
   { "say": "為什麼需要三種?各有各的設計理由。", "item": 0 },
   { "say": "topic 傳的是連續的狀態。雷達每零點一秒一筆,舊資料很快就失去價值,所以不需要確認,也不需要回應。它是單向、多對多、開銷低。", "item": 1 },
   { "say": "服務是一次性的一問一答。呼叫端會等待回應,所以只適合很快就能回答的事情;如果伺服器忙了五分鐘,呼叫端就整個卡住了。", "item": 2 },
   { "say": "動作是長時間任務。它其實是由幾個服務,也就是送目標、取消、取結果,再加上一個回饋 topic 組成的,所以才有接受、執行中、成功、取消、中止這些狀態。", "item": 3 }
  ],
  "原理:話題、服務、動作與 QoS 的設計取捨#3": [
   { "say": "我們來看動作目標的生命週期圖。", "item": 0 },
   { "say": "從左邊看起,目標先被接受,然後進入執行中。執行期間會一直回報回饋,中途可以被取消。最後有三種結局,成功、已取消,或是中止。", "item": 1 }
  ],
  "原理:話題、服務、動作與 QoS 的設計取捨#4": [
   { "say": "接著談 QoS,為什麼同一種 topic 需要不同規則?", "item": 0 },
   { "say": "感測器資料要新鮮、低延遲,掉幾筆沒關係,適合 best effort 加上小佇列。地圖只發布一次,之後不變,要讓晚加入的人也拿得到,適合 reliable 加上 transient local。速度指令則介於兩者之間。", "item": 1 },
   { "say": "相容規則的核心是,訂閱者要求的,不能比發布者提供的更嚴格。發布者既然只承諾盡力而為,就不可能滿足要求保證送達的訂閱者,所以兩邊不連線,而且不會報錯。", "item": 1 }
  ],
  "原理:話題、服務、動作與 QoS 的設計取捨#5": [
   { "say": "這是 QoS 相容矩陣。", "item": 0 },
   { "say": "表格分成可靠性和持久性兩塊,各自列出發布者與訂閱者的組合,哪些可以連線、哪些不行。遇到收不到資料時,可以拿這張表對照,看看雙方是不是設定不相容。", "item": 1 }
  ],
  "原理:話題、服務、動作與 QoS 的設計取捨#6": [
   { "say": "來看一個數字例子,佇列深度怎麼影響延遲。", "item": 0 },
   { "say": "發布者每秒三十筆,也就是每三十三點三毫秒一筆;但訂閱者每筆要處理一百毫秒,一秒只能處理十筆。", "item": 1 },
   { "say": "如果佇列深度是十,大約零點五秒佇列就滿了,之後新訊息會擠掉最舊的。穩定之後,每筆訊息要排在大約十筆後面,等待約十乘零點一,也就是一秒。你處理的永遠是一秒前的資料。", "item": 1 },
   { "say": "如果深度改成一,資料大約只舊零點一秒,代價是丟掉大部分中間的資料。控制用的資料,通常選後者。", "item": 1 }
  ],
  "原理:話題、服務、動作與 QoS 的設計取捨#7": [
   { "say": "最後整理幾個常見的迷思與限制。", "item": 0 },
   { "say": "第一個迷思,reliable 一定比 best effort 好。其實可靠重送會增加延遲,網路不佳時還可能讓佇列堆積。感測器資料常常寧可丟舊的。", "item": 1 },
   { "say": "第二個,用服務傳影像比較方便。不是的,服務是一問一答,不適合連續資料。", "item": 2 },
   { "say": "第三個,動作取消了機器人就一定立刻停。要注意,取消只是一個請求,要由伺服器處理。安全相關的停止,必須另外有獨立的機制,也就是急停。", "item": 3 },
   { "say": "另外,各項 QoS 預設值依版本而異,不確定時,可以用 topic info 加上 verbose 看實際值。", "item": 3 }
  ],
  "節點與話題:rclpy 發布者與訂閱者#1": [
   { "say": "好,接下來進入動手寫程式的部分,先認識 node 和 topic。", "item": 0 },
   { "say": "R O S 二的 node,是一個小而專一的程序,例如讀雷達、算避障、驅動馬達。node 之間靠 topic 交換資料,發布者把訊息送到某個 topic,訂閱者從那個 topic 收訊息。", "item": 1 },
   { "say": "發布者不知道誰在聽,訂閱者也不知道是誰在講,這就叫解耦,你可以隨時換掉其中一個 node 而不影響其他。", "item": 1 },
   { "say": "這張圖有個重要的設計。遙控 node 發布到 cmd vel raw 這個 topic,由 safety node 檢查後,才發布真正的 cmd vel。", "item": 2 }
  ],
  "節點與話題:rclpy 發布者與訂閱者#2": [
   { "say": "我們看這張計算圖範例。", "item": 0 },
   { "say": "左邊是雷達和遙控 node,它們透過 topic 把資料送到中間的安全 node,再由安全 node 送到最右邊的底盤驅動 node。所有速度指令都會經過同一個關卡,這正是後面章節的安全做法。", "item": 1 }
  ],
  "節點與話題:rclpy 發布者與訂閱者#3": [
   { "say": "每個 topic 都有固定的訊息型別。", "item": 0 },
   { "say": "例如 std msgs 的 String,就是只裝一個字串的訊息。", "item": 1 },
   { "say": "要注意,發布者和訂閱者的型別必須相同,否則無法連線。", "item": 2 },
   { "say": "你可以用 interface show 這個指令,看某個型別的欄位。", "item": 3 },
   { "say": "String 的內容很簡單,只有一個叫 data 的字串欄位。", "item": 4 }
  ],
  "節點與話題:rclpy 發布者與訂閱者#4": [
   { "say": "我們來看一個完整的發布者範例。", "item": 0 },
   { "say": "這是一個每零點五秒發布一次字串的 node,用 R C L py 寫的,Humble 和 Jazzy 都適用。", "item": 1 },
   { "say": "初始化的部分,先建立發布者,topic 名稱叫 chatter,型別是 String,最後的十是佇列深度。再建立一個計時器,每零點五秒呼叫一次計時回呼。", "item": 2 },
   { "say": "計時回呼裡,建立一個訊息,內容是 hello 加上計數,發布出去,印一行日誌,計數再加一。", "item": 3 },
   { "say": "main 函式負責初始化 R C L py、建立 node,然後用 spin 讓 node 持續運作,按 Ctrl C 時乾淨地關閉。", "item": 4 },
   { "say": "有幾個重點。create publisher 第三個參數十,是佇列深度。create timer 的第一個參數是秒,零點五秒就是兩赫茲,十秒會發二十則。還有 spin 會讓 node 持續處理回呼,沒有 spin,node 什麼都不會發生。", "item": 5 }
  ],
  "節點與話題:rclpy 發布者與訂閱者#5": [
   { "say": "這一頁是程式的前半段。", "item": 0 },
   { "say": "先匯入 R C L py。", "item": 1 },
   { "say": "再匯入 Node 類別,所有 node 都繼承它。", "item": 2 },
   { "say": "然後匯入 std msgs 的 String 訊息型別。", "item": 3 },
   { "say": "最後定義 Talker 這個類別,繼承 Node。", "item": 4 }
  ],
  "節點與話題:rclpy 發布者與訂閱者#6": [
   { "say": "程式的後半段是進入點。", "item": 0 },
   { "say": "main 函式裡做初始化、建立 node、spin,再收尾。", "item": 1 },
   { "say": "最後這一行是 Python 的慣例,檔案直接執行時才呼叫 main。", "item": 2 }
  ],
  "節點與話題:rclpy 發布者與訂閱者#7": [
   { "say": "接著是訂閱者的範例。", "item": 0 },
   { "say": "訂閱者建立時,指定型別是 String,topic 是 chatter,收到訊息要呼叫的函式,以及佇列深度十。", "item": 1 },
   { "say": "收到訊息的回呼函式很簡單,就是把收到的內容印到日誌。", "item": 2 },
   { "say": "main 的寫法和發布者一樣。要注意,回呼函式不要做太久的事,例如跑一秒的運算,因為預設的單執行緒執行器一次只處理一個回呼,卡住會讓別的訂閱與計時器全部延遲。需要重運算時,可以考慮多執行緒執行器,或把運算放到別的 node。", "item": 3 }
  ],
  "服務、動作與參數:什麼時候用哪一種#1": [
   { "say": "接下來,什麼時候用哪一種通訊方式?我們來做個整理。", "item": 0 },
   { "say": "topic 是持續的資料流,像雷達掃描、里程計、速度指令,多對多、單向、不等回應。", "item": 1 },
   { "say": "服務是一次性、短時間的一問一答,像清除地圖、查詢目前模式、儲存設定。客戶端送出請求,等伺服器回應。不適合花很久的事,因為客戶端會一直等。", "item": 2 },
   { "say": "動作是長時間任務,像導航到某一點,可能要兩分鐘。客戶端送出目標,伺服器接受後持續回報回饋,最後給結果,途中客戶端還可以取消。", "item": 3 },
   { "say": "判斷口訣是,要持續更新用 topic,問一個馬上能答的問題用服務,要做很久、要看進度、可能要中止就用動作。機器人導航一定是動作,因為使用者必須能在撞到之前取消。", "item": 3 }
  ],
  "服務、動作與參數:什麼時候用哪一種#2": [
   { "say": "這張是三種通訊方式的時序圖。", "item": 0 },
   { "say": "第一段是 topic,持續單向送出。第二段是服務,一次請求,一次回應。第三段是動作,包含送目標、持續回饋、最後結果,中間還有一個可選的取消。對照著看,就能感受到三者的節奏差別。", "item": 1 }
  ],
  "服務、動作與參數:什麼時候用哪一種#3": [
   { "say": "我們用 turtlesim 來練習服務。", "item": 0 },
   { "say": "先啟動 turtlesim node,再開另一個終端機。", "item": 1 },
   { "say": "spawn 這個服務,會生出第二隻烏龜。", "item": 2 },
   { "say": "第一個指令是 service list 加上 減 t,列出所有服務和型別。", "item": 3 },
   { "say": "第二個是呼叫 clear 服務,把畫面上的軌跡清掉。", "item": 4 },
   { "say": "第三個是呼叫 spawn 服務,並帶入新烏龜的位置和名字。", "item": 5 }
  ],
  "服務、動作與參數:什麼時候用哪一種#4": [
   { "say": "接著看服務的伺服器與客戶端怎麼用 R C L py 寫。", "item": 0 },
   { "say": "先看伺服器端。", "item": 1 },
   { "say": "初始化時,用 create service 建立一個服務,型別是兩個整數相加,服務名稱叫 add two ints,並指定處理函式。", "item": 2 },
   { "say": "處理函式拿到請求,把 a 和 b 相加,放進回應的 sum 欄位再回傳。接著是客戶端。", "item": 3 },
   { "say": "客戶端初始化時,建立 client,並等到服務上線。", "item": 4 },
   { "say": "送出請求時,建立請求、填入 a 和 b,用 call async 非同步呼叫,等結果出來再取出 sum。", "item": 5 },
   { "say": "有一點要小心,在服務的回呼裡,不要再同步等待另一個服務的結果,容易造成死結。請用 call async,並以 future 處理。", "item": 5 }
  ],
  "服務、動作與參數:什麼時候用哪一種#5": [
   { "say": "畫面上是服務範例的類別定義。", "item": 0 },
   { "say": "第一行匯入 example interfaces 裡的 AddTwoInts 服務型別。", "item": 1 },
   { "say": "AddServer 是伺服器類別,負責回答加法。", "item": 2 },
   { "say": "AddClient 是客戶端類別,負責送出請求。你可以用指令列驗證,呼叫 add two ints,a 給三、b 給四,回應的 sum 應該是七。", "item": 3 }
  ],
  "服務、動作與參數:什麼時候用哪一種#6": [
   { "say": "再來是動作,特色是有回饋、可取消。", "item": 0 },
   { "say": "turtlesim 也有動作,可以讓烏龜旋轉到指定角度。", "item": 1 },
   { "say": "執行時,你會看到回饋持續顯示剩餘角度,最後得到結果。", "item": 2 },
   { "say": "第一個指令是 action list 加 減 t,列出動作。", "item": 3 },
   { "say": "第二個指令是 action send goal,對烏龜的旋轉動作送出目標。", "item": 4 }
  ],
  "服務、動作與參數:什麼時候用哪一種#7": [
   { "say": "最後一種是參數。", "item": 0 },
   { "say": "參數是 node 在執行期間可以讀寫的設定值,例如速度上限、閾值。", "item": 1 },
   { "say": "程式裡用 declare parameter 宣告參數,並給預設值,再用 get parameter 取出來用。", "item": 2 },
   { "say": "指令列這邊,param list 列出參數。", "item": 3 },
   { "say": "param get 讀取 turtlesim 的背景紅色值。", "item": 4 },
   { "say": "param set 則是修改它,畫面上的背景顏色就會跟著變。", "item": 5 }
  ],
  "QoS:為什麼訊息「明明有發卻收不到」#1": [
   { "say": "好,接下來講 QoS,為什麼訊息明明有發,卻收不到?", "item": 0 },
   { "say": "QoS 是服務品質,是 R O S 二替每個發布者和訂閱者設定的通訊規則。網路不完美、感測器很快、地圖只發一次,不同資料需要不同規則。", "item": 1 },
   { "say": "如果雙方規則不相容,連線會靜默失敗:兩個 node 都正常執行,卻互相收不到資料。這是初學者最常遇到、也最難猜的問題之一。", "item": 1 }
  ],
  "QoS:為什麼訊息「明明有發卻收不到」#2": [
   { "say": "我們來看三個最常用的設定。", "item": 0 },
   { "say": "第一個是可靠性。reliable 掉包會重送,保證送到,但可能增加延遲;best effort 是盡力而為,掉了就算,延遲低。", "item": 1 },
   { "say": "第二個是持久性。volatile 只送給當下已經連上的訂閱者;transient local 則是發布者會保留最後幾筆,晚加入的訂閱者也能拿到。", "item": 2 },
   { "say": "第三個是歷史與深度。keep last 加上深度,只保留最近 N 筆,或是 keep all 全部保留。", "item": 3 },
   { "say": "實際使用上,雷達、相機這類高頻感測資料,驅動通常用 best effort。如果你的訂閱者預設是 reliable,就收不到。R C L py 提供現成的 qos profile sensor data 可以用。", "item": 4 },
   { "say": "地圖 topic 只發布很少次,地圖伺服器用 transient local,讓晚開的 R viz 二仍然拿得到地圖。R viz 二的 Map 顯示,要把 Durability 設成 Transient Local,否則畫面是空的。", "item": 5 }
  ],
  "QoS:為什麼訊息「明明有發卻收不到」#3": [
   { "say": "再看相容規則,先看三個例子。", "item": 0 },
   { "say": "發布者是 reliable、訂閱者是 best effort,可以連線,因為訂閱者要求的比較寬鬆。", "item": 1 },
   { "say": "反過來,發布者 best effort、訂閱者 reliable,不相容,收不到。", "item": 2 },
   { "say": "持久性也一樣,發布者 volatile、訂閱者 transient local,不相容。", "item": 3 }
  ],
  "QoS:為什麼訊息「明明有發卻收不到」#4": [
   { "say": "還有最後一個例子。", "item": 0 },
   { "say": "發布者 transient local、訂閱者 volatile,可以連線。原則就是,訂閱者的要求不能比發布者的承諾更嚴格。", "item": 1 }
  ],
  "QoS:為什麼訊息「明明有發卻收不到」#5": [
   { "say": "接著看在 R C L py 裡怎麼設定。", "item": 0 },
   { "say": "畫面上是建立 QoS 設定檔時,指定持久性與歷史策略的那一段。各項預設值依版本與函式而異,不確定時,請用 topic info 加上 verbose,看對方實際用了什麼。", "item": 1 }
  ],
  "QoS:為什麼訊息「明明有發卻收不到」#6": [
   { "say": "程式的前半段是匯入。", "item": 0 },
   { "say": "第一行從 rclpy qos 匯入 QoS 設定檔、可靠性、持久性、歷史這些類別,還有感測器資料的現成設定。", "item": 1 },
   { "say": "第二行匯入雷達掃描的訊息型別。", "item": 2 },
   { "say": "第三行是註解,方式一,直接用感測器資料的現成設定。", "item": 3 }
  ],
  "QoS:為什麼訊息「明明有發卻收不到」#7": [
   { "say": "後半段是實際用法。", "item": 0 },
   { "say": "方式一,建立訂閱時,把現成的感測器 QoS 設定傳進去,用來訂閱雷達 scan。", "item": 1 },
   { "say": "方式二是自訂,例如接收地圖的情況。", "item": 2 },
   { "say": "自訂的設定是深度一、reliable、transient local、keep last,這樣就能拿到晚開時錯過的地圖。", "item": 3 }
  ],
  "closing": [
   { "say": "好,這一章我們學了 topic、服務、動作的分工,用 R C L py 寫了發布者和訂閱者,也看到 QoS 不相容會讓訊息悄悄收不到。", "item": 0 },
   { "say": "請接著完成本章的實作,並做章末小測驗,檢查自己學會了多少。下一章見。", "item": 1, "pause": 1 }
  ]
 }
}
