机器人 / 系统课时
检查消息类型与字段结构
检查消息类型与字段结构
订阅端知道话题名,却不确定消息该用什么类型时,可以直接从运行中的话题反查接口,再核对一条真实数据。本例在 ROS 2 Jazzy 中创建一个持续发布的测试话题,依次确认话题类型、字段声明和终端看到的数据格式。
学习目标
- 使用
ros2 topic type确定话题的完整消息类型。 - 使用
ros2 interface show识别字段名称、数据类型与嵌套关系。 - 使用
ros2 topic echo对照实际消息,并定位常见查询失败原因。
启动可检查的话题
准备已安装 ROS 2 Jazzy 的 Ubuntu 24.04 环境,打开终端 A。这里使用标准消息 std_msgs/msg/String 发布固定文本,每秒发送一次,不依赖额外编写节点。
source /opt/ros/jazzy/setup.bash
# 保持此终端运行,以便另一终端发现发布者
ros2 topic pub -r 1 /lesson_chatter std_msgs/msg/String "{data: 'hello ros2'}"预期输出(节选,后续发布序号会递增):
publisher: beginning loop
publishing #1: std_msgs.msg.String(data='hello ros2')/lesson_chatter 是话题名;std_msgs/msg/String 才是消息类型。-r 1 表示以 1 Hz 发送。检查结束后在终端 A 按 Ctrl+C 停止发布。
从话题反查消息类型
保持终端 A 运行,打开终端 B,加载同一个 ROS 环境后查询:
source /opt/ros/jazzy/setup.bash
ros2 topic type /lesson_chatter预期输出:
std_msgs/msg/String完整类型名由包名 std_msgs、接口类别 msg 和类型名 String 组成。也可用 ros2 topic list -t 同时列出当前可发现的话题及其类型;不要把 /lesson_chatter 当作接口类型传给 ros2 interface show。
读取字段声明
使用刚查询到的完整类型名,而不是自行猜测字段:
ros2 interface show std_msgs/msg/String预期输出的有效字段(命令还会显示接口原有的注释):
string data消息定义按“字段类型 字段名”书写:string 表示字符串,data 是必须按名称访问的字段。它没有额外的 text 或 message 字段。对于复合消息,例如 geometry_msgs/msg/Twist,可继续用同一命令查看 linear、angular 两个 Vector3 成员及其中的 float64 x、y、z,不能把嵌套成员当成顶层字段。
对照真实数据并处理异常
仍在终端 B 读取一条消息;--once 会在收到首条消息后退出:
ros2 topic echo /lesson_chatter --once预期输出:
data: hello ros2
---data: 对应接口声明中的字段名,hello ros2 是发布时给定的值,末尾 --- 是终端输出中消息样本的分隔标记,而不是消息字段。echo 显示的是便于阅读的 YAML 风格数据,不代表 .msg 接口定义本身采用 YAML。
如果查不到话题,先确认终端 A 仍在发布,并检查两端是否加载了 ROS 2 环境且 ROS_DOMAIN_ID 一致;发现信息可能有短暂延迟。如果能查到话题、却不能解析自定义消息类型,先确认包含该接口的功能包已构建并在终端 B 加载工作空间的 install/setup.bash。接口定义能显示,不等于发布和订阅一定互通,还需核对两端消息类型和 QoS 是否兼容。