【ROS教程】ROS常用API講解

来源:https://www.cnblogs.com/UnderTurrets/p/18382507
-Advertisement-
Play Games

@目錄1.節點初始化2.話題通信2.1 創建發佈者對象2.2 消息發佈2.3 創建訂閱者對象3.服務通信3.1 創建服務對象3.2 創建客戶對象3.3 客戶發送請求3.4 客戶對象等待服務4. 迴旋函數4.1 spin4.2 spinOnce5.時間5.1 時刻5.1.1 獲取當前時刻5.1.2 設 ...


@

目錄

1.節點初始化

ROSCPP_DECL void init(int &argc, char **argv, const std::string& name, uint32_t options = 0);
ROSCPP_DECL void init(const M_string& remappings, const std::string& name, uint32_t options = 0);
ROSCPP_DECL void init(const VP_string& remapping_args, const std::string& name, uint32_t options = 0);
  • 這裡講解第一種初始化方式
參數 含義
argc main函數的第一個參數
argv main函數的第二個參數
name 節點的名字，必須是唯一的

2.話題通信

2.1 創建發佈者對象

template <class M>
Publisher NodeHandle::advertise(const std::string& topic, uint32_t queue_size, bool latch = false);
  
template <class M>
Publisher NodeHandle::advertise(const std::string& topic, uint32_t queue_size,
                        const SubscriberStatusCallback& connect_cb,
                        const SubscriberStatusCallback& disconnect_cb = SubscriberStatusCallback(),
                        const VoidConstPtr& tracked_object = VoidConstPtr(),
                        bool latch = false);
  • 這裡講解第一種構造方式
參數 含義
topic 話題的名字，必須是唯一的
queue_size 等待發送給訂閱者的最大消息數量
latch 如果為 true,該話題發佈的最後一條消息將被保存，並且後期當有訂閱者連接時會將該消息發送給訂閱者

2.2 消息發佈

template <typename M>
      void Publisher::publish(const M& message) const;
參數 含義
message 被組織的消息

2.3 創建訂閱者對象

template<class M>
Subscriber NodeHandle::subscribe(const std::string& topic, uint32_t queue_size, void(*fp)(const boost::shared_ptr<M const>&), const TransportHints& transport_hints = TransportHints());

template<class M>
Subscriber NodeHandle::subscribe(const std::string& topic, uint32_t queue_size, const boost::function<void (const boost::shared_ptr<M const>&)>& callback,
                         const VoidConstPtr& tracked_object = VoidConstPtr(), const TransportHints& transport_hints = TransportHints());
參數 含義
topic 話題的名字，必須是唯一的
queue_size main函數的第二個參數
fp 回調函數的函數指針
return 調用成功時，返回一個訂閱者對象，失敗時，返回空對象

3.服務通信

3.1 創建服務對象

  template<class T, class MReq, class MRes>
  ServiceServer NodeHandle::advertiseService(const std::string& service, bool(T::*srv_func)(MReq &, MRes &), T *obj);
  
  template<class T, class MReq, class MRes>
  ServiceServer NodeHandle::advertiseService(const std::string& service, bool(T::*srv_func)(ServiceEvent<MReq, MRes>&), T *obj);

  template<class T, class MReq, class MRes>
  ServiceServer NodeHandle::advertiseService(const std::string& service, bool(T::*srv_func)(MReq &, MRes &), const boost::shared_ptr<T>& obj);

  template<class T, class MReq, class MRes>
  ServiceServer NodeHandle::advertiseService(const std::string& service, bool(T::*srv_func)(ServiceEvent<MReq, MRes>&), const boost::shared_ptr<T>& obj);

  template<class MReq, class MRes>
  ServiceServer NodeHandle::advertiseService(const std::string& service, bool(*srv_func)(MReq&, MRes&));

  template<class MReq, class MRes>
  ServiceServer NodeHandle::advertiseService(const std::string& service, bool(*srv_func)(ServiceEvent<MReq, MRes>&));
  
  template<class MReq, class MRes>
  ServiceServer NodeHandle::advertiseService(const std::string& service, const boost::function<bool(MReq&, MRes&)>& callback, 
                                 const VoidConstPtr& tracked_object = VoidConstPtr());

  template<class S>
  ServiceServer NodeHandle::advertiseService(const std::string& service, const boost::function<bool(S&)>& callback, 
                                 const VoidConstPtr& tracked_object = VoidConstPtr());
參數 含義
service 服務名稱，必須是唯一的
srv_func 接收到請求時，需要處理請求的回調函數
return 請求成功時返回服務對象，否則返回空對象

3.2 創建客戶對象

  template<class MReq, class MRes>
  ServiceClient NodeHandle::serviceClient(const std::string& service_name, bool persistent = false, 
                              const M_string& header_values = M_string());
  template<class Service>
  ServiceClient NodeHandle::serviceClient(const std::string& service_name, bool persistent = false, 
                              const M_string& header_values = M_string());
參數 含義
service_name 服務名稱，必須是唯一的

3.3 客戶發送請求

  template<class Service>
  bool ServiceClient::call(Service& service);
參數 含義
service .srv文件定義的服務類型

3.4 客戶對象等待服務

ROSCPP_DECL bool service::waitForService(const std::string& service_name, int32_t timeout);
ROSCPP_DECL bool service::waitForService(const std::string& service_name, ros::Duration timeout = ros::Duration(-1));
參數 含義
service_name 被等待的服務名稱，必須是唯一的
timeout 等待最大時常，預設為 -1，可以永久等待直至節點關閉
return 成功返回 true，否則返回 false

4. 迴旋函數

  • 簡而言之，用到回調函數，就要用迴旋函數處理

4.1 spin

/** 
 * \brief 進入迴圈處理回調 
 */
ROSCPP_DECL void spin();

4.2 spinOnce

/**
 * \brief 處理一輪迴調
 *
 * 一般應用場景:
 *     在迴圈體內，處理所有可用的回調函數
 * 
 */
ROSCPP_DECL void spinOnce();

5.時間

5.1 時刻

5.1.1 獲取當前時刻

ros::init(argc,argv,"hello_time");
ros::NodeHandle nh;//必須創建句柄，否則時間沒有初始化，導致後續API調用失敗
ros::Time right_now = ros::Time::now();//將當前時刻封裝成對象
ROS_INFO("當前時刻:%.2f",right_now.toSec());//獲取距離 1970年01月01日 00:00:00 的秒數
ROS_INFO("當前時刻:%d",right_now.sec);//獲取距離 1970年01月01日 00:00:00 的秒數

5.1.2 設置時刻

ros::init(argc,argv,"hello_time");
ros::NodeHandle nh;//必須創建句柄，否則時間沒有初始化，導致後續API調用失敗
ros::Time someTime(100,100000000);// 參數1:秒數  參數2:納秒
ROS_INFO("時刻:%.2f",someTime.toSec()); //100.10
ros::Time someTime2(100.3);//直接傳入 double 類型的秒數
ROS_INFO("時刻:%.2f",someTime2.toSec()); //100.30

5.2 時間間隔

5.2.1 設置時間間隔

ros::init(argc,argv,"hello_time");
ros::NodeHandle nh;//必須創建句柄，否則時間沒有初始化，導致後續API調用失敗
ros::Duration du(10);//持續10秒鐘,參數是double類型的，以秒為單位
ROS_INFO("持續時間:%.2f",du.toSec());//將持續時間換算成秒

5.2.2 進行休眠

ros::init(argc,argv,"hello_time");
ros::NodeHandle nh;//必須創建句柄，否則時間沒有初始化，導致後續API調用失敗
ros::Duration du(10);//持續10秒鐘,參數是double類型的，以秒為單位
du.sleep();//按照指定的持續時間休眠

5.3 設置運行頻率

Rate::Rate(double frequency);
參數 含義
frequency 運行頻率

6.參數設置

6.1 修改或新增參數

  void NodeHandle::setParam(const std::string& key, const XmlRpc::XmlRpcValue& v) const;
  void NodeHandle::setParam(const std::string& key, const std::string& s) const;
  void NodeHandle::setParam(const std::string& key, const char* s) const;
  void NodeHandle::setParam(const std::string& key, double d) const;
  void NodeHandle::setParam(const std::string& key, int i) const;
  void NodeHandle::setParam(const std::string& key, bool b) const;
  void NodeHandle::setParam(const std::string& key, const std::vector<std::string>& vec) const;
  void NodeHandle::setParam(const std::string& key, const std::vector<double>& vec) const;
  void NodeHandle::setParam(const std::string& key, const std::vector<float>& vec) const;
  void NodeHandle::setParam(const std::string& key, const std::vector<int>& vec) const;
  void NodeHandle::setParam(const std::string& key, const std::vector<bool>& vec) const;
  void NodeHandle::setParam(const std::string& key, const std::map<std::string, std::string>& map) const;
  void NodeHandle::setParam(const std::string& key, const std::map<std::string, double>& map) const;
  void NodeHandle::setParam(const std::string& key, const std::map<std::string, float>& map) const;
  void NodeHandle::setParam(const std::string& key, const std::map<std::string, int>& map) const;
  void NodeHandle::setParam(const std::string& key, const std::map<std::string, bool>& map) const;
  • ROS提供了16種可以設置的參數類型，如上。
  • 使用 ros::param::set有完全相同的效果

6.2 獲取參數

/*
    參數伺服器操作之查詢_C++實現:
    在 roscpp 中提供了兩套 API 實現參數操作
  
    ros::NodeHandle::param(鍵,預設值) 
            存在，返回對應結果，否則返回預設值

    ros::NodeHandle::getParam(鍵,存儲結果的變數)
            存在,返回 true,且將值賦值給參數2
            若果鍵不存在，那麼返回值為 false，且不為參數2賦值

    ros::NodeHandle::getParamCached(鍵,存儲結果的變數)--提高變數獲取效率
            存在,返回 true,且將值賦值給參數2
            若果鍵不存在，那麼返回值為 false，且不為參數2賦值

    ros::NodeHandle::getParamNames(std::vector<std::string>)
            獲取所有的鍵,並存儲在參數 vector 中 

    ros::NodeHandle::hasParam(鍵)
            是否包含某個鍵，存在返回 true，否則返回 false

    ros::NodeHandle::searchParam(參數1，參數2)
            搜索鍵，參數1是被搜索的鍵，參數2存儲搜索結果的變數

    ros::param ----- 與 NodeHandle 類似
*/

6.3 刪除參數

/* 
    參數伺服器操作之刪除_C++實現:

    ros::NodeHandle::deleteParam("鍵")
        根據鍵刪除參數，刪除成功，返回 true，否則(參數不存在)，返回 false

    ros::param::del("鍵")
        根據鍵刪除參數，刪除成功，返回 true，否則(參數不存在)，返回 false
*/

本文由博客一文多發平臺 OpenWrite 發佈！


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 【ROS教程】編寫launch文件
    @目錄1.launch文件有哪些標簽2.node標簽2.1 必選屬性2.2 可選屬性2.3 可選子級標簽3.include標簽3.1 必選屬性3.2 可選屬性3.3 可選子級標簽4.remap標簽4.1 必選屬性5.param標簽5.1 必選屬性5.2 可選屬性6.rosparam標簽6.1 必選屬 ...
  • 【ROS教程】用CLion編譯和調試ROS包的全流程及可能遇到的問題
    @目錄1.工作空間目錄2.載入環境變數3.打開CLion4.配置CLion5.編譯和調試軟體包 1.工作空間目錄 我們的一個工作空間目錄應該是這樣的 2.載入環境變數 先進入工作空間再載入 source ./devel/setup.bash 3.打開CLion 一定要在第二步的同一個終端下 clio ...
  • 【ROS教程】服務通信
    @目錄1.流程2.自定義請求和響應的數據2.1 std_msgs內置類型2.2 編寫.srv文件2.3 修改package.xml文件2.4 修改CMakeLists.txt文件2.4.1 修改find_package指令2.4.2 添加add_message_files指令2.4.3 添加gene ...
  • 架構實戰
    所謂架構，意即系統架構，廣義上它涵蓋業務架構、運維架構、組織架構等所有系統構建場景，本文特指一般開發人員主要關註的開發架構。 關於架構的理論有很多，每個人也都有各自的理解，筆者相信很多人在實際運用中也會遇到各種各樣的問題和困惑，本文拋開教條，從一個實際項目的演化看何為架構。 項目背景 開始之前，先了 ...
  • 【ROS教程】安裝ROS全流程及可能遇到的問題
    @目錄1.配置Softerware & Updates2.添加軟體源3.設置key4.更新並安裝4.1 更新4.2 安裝(ros-noetic-desktop-full)4.2.1 安裝aptitude4.2.2 安裝ROS軟體包5.添加環境變數6.安裝構建依賴7.初始化和更新7.1 初始化7.1. ...
  • 萬丈高樓平地起：UML類圖
    UML類圖 UML類圖 是一種靜態的結構圖，描述了系統的類的集合，類的屬性和類之間的關係，可以簡化了人們對系統的理解。UML類圖 是系統分析和設計階段的重要產物，是系統編碼和測試的重要模型。 圖示 類 解析 圓角矩形框，它就代表一個類（Class） 類圖分為三層： 第一層顯示類的名稱，如果是抽象類， ...
  • 【ROS教程】ROS文件系統和基礎架構
    @目錄1.工作空間目錄1.1 package.xml2.啟動節點的方式2.1 一次啟動一個2.2 一次啟動多個3.ROS常用命令3.1 增3.2 查3.3 執行3.3.1 載入環境變數3.3.2 運行節點3.4 查看計算圖4.創建功能包4.1 選擇工作目錄4.2 創建功能包目錄4.3 建立功能包 1 ...
  • 【ROS教程】ROS常用命令
    @目錄1.rosnode1.1 rosnode ping1.1.1 測試所有節點的連接狀態1.1.2 測試到某個節點的連接狀態1.2 rosnode list1.3 rosnode info1.4 rosnode machine1.4.1 列出所有設備1.4.2 查看指定設備上的運行節點1.5 ro ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類