寫 ROS 節點時,幾乎每個訂閱者範例的最後都會出現 ros::spin() 或 ros::spinOnce()。兩者看起來相似,行為卻關鍵不同,用錯會導致回呼永遠不被觸發,或資料大量堆積延遲。
這兩個函式的正式名稱是「ROS 訊息回呼處理函式」,通常放在主迴圈中,程式需要不斷呼叫其中之一。
原理其實不複雜。ROS 建立在發布/訂閱機制上:你的程式註冊了訂閱者與回呼函式之後,ROS 會在背景依格式接收訊息,但收到的訊息不會立刻被處理,而是要等到 ros::spin() 或 ros::spinOnce() 被呼叫時,才會真正觸發回呼。這就是回呼處理函式的角色——它是「把佇列中的訊息消化掉」的動作。
ros::spin() 呼叫後不再返回,主程式執行到這裡就停在原地,持續處理回呼,直到收到 Ctrl+C 或 ROS 關閉。
ros::spinOnce() 只處理一次就返回,後續程式碼可以繼續執行。若還想再處理,得自己包在迴圈裡。
從函式名稱也能猜個大概:一個是「持續轉」,一個是「轉一次」。
ros::spin() 不要放進迴圈。既然呼叫後就不返回,迴圈只會是第一圈有意義,之後的程式碼永遠不會執行。同理,spin() 之後除了 return 0 之外不該有其他語句——寫了也不會跑到。
ros::spinOnce() 需要自己協調頻率。它的用法靈活,可以放在程式任何位置,但必須考慮三件事:回呼的呼叫時機、呼叫頻率、以及訊息佇列(message pool)的大小。這三者沒配好,就會出現資料丟失或延遲。
特別強調:如果你的程式寫了訂閱回呼,千萬不要忘記在適當位置加上 ros::spin() 或 ros::spinOnce(),否則永遠收不到任何訊息。這是新手最常踩的坑之一。
發送端:
#include "ros/ros.h" #include "std_msgs/String.h" #include <sstream> int main(int argc, char **argv) { ros::init(argc, argv, "talker"); ros::NodeHandle n; ros::Publisher chatter_pub = n.advertise<std_msgs::String>("chatter", 1000); ros::Rate loop_rate(10); int count = 0; while (ros::ok()) { std_msgs::String msg; std::stringstream ss; ss << "hello world " << count; msg.data = ss.str(); ROS_INFO("%s", msg.data.c_str()); /** * 向 Topic: chatter 發送消息, 發送頻率為10Hz(1秒發10次);消息池最大容量1000。 */ chatter_pub.publish(msg); loop_rate.sleep(); ++count; } return 0; }
接收端:
#include "ros/ros.h" #include "std_msgs/String.h" void chatterCallback(const std_msgs::String::ConstPtr& msg) { ROS_INFO("I heard: [%s]", msg->data.c_str()); } int main(int argc, char **argv) { ros::init(argc, argv, "listener"); ros::NodeHandle n; ros::Subscriber sub = n.subscribe("chatter", 1000, chatterCallback); /** * ros::spin() 將會進入循環, 一直調用回調函數chatterCallback(),每次調用1000個數據。 * 當用戶輸入Ctrl+C或者ROS主進程關閉時退出, */ ros::spin(); return 0; }
它更自由,但需要考虑的因素更多。最重要的一點是佇列大小與呼叫頻率的關係:假設訊息送達頻率是 10Hz,而 spinOnce() 的呼叫頻率是 5Hz,那麼佇列大小就必須大於 2,才能避免訊息被覆蓋丟失。
/**接收端**/<br>#include "ros/ros.h" #include "std_msgs/String.h" void chatterCallback(const std_msgs::String::ConstPtr& msg) { /*...TODO...*/ } int main(int argc, char **argv) { ros::init(argc, argv, "listener"); ros::NodeHandle n; ros::Subscriber sub = n.subscribe("chatter", 2, chatterCallback); ros::Rate loop_rate(5); while (ros::ok()) { /*...TODO...*/ ros::spinOnce(); loop_rate.sleep(); } return 0; }
另一個建議:對於你自己定義的週期性任務,最好與 spinOnce() 並列在主迴圈中執行,而不是塞進回呼函式裡。這樣任務節奏由 loop_rate 掌握,回呼則專心處理訊息,兩者職責分明,也更容易推理延遲:
/*...TODO...*/ ros::Rate loop_rate(100); while (ros::ok()) { /*...TODO...*/ user_handle_events_timeout(...); ros::spinOnce(); loop_rate.sleep(); }
只有訂閱、沒有其他週期性工作的節點,用 ros::spin() 最省事。需要同時做控制迴圈、讀寫硬體、更新參數的節點,用 ros::spinOnce() 搭配 ros::Rate 主迴圈。若有多個回呼需要不同執行緒或優先順序,則該考慮 ros::CallbackQueue 與 ros::AsyncSpinner。
另外提醒:在 ROS 2 中這套 API 已改為 rclcpp::spin(node) 與 rclcpp::spin_some(node),概念相同但名稱與所在的命名空間不同,遷移時別混淆。