本系列教程作者：小鱼
公众号：鱼香ROS
QQ交流群：139707339
教学视频地址：小鱼的B站
完整文档地址：鱼香ROS官网
版权声明：如非允许禁止转载与商业用途。
4.3.2 自定义话题接口
本节小鱼带大家一起新建一个消息接口，帮李四的艳娘传奇每一章插入一图。
1.如何自定义话题接口
通过前几节的学习大家已经明白，话题是一种单向通信的接口，同一个话题只能由发布者将数据传递给订阅者，所以定义话题接口也只需要定义发布者所要发布的类型即可。
在实际的工程当中，为了减少功能包互相之间的依赖，通常会将接口定义在一个独立的功能包中，所以小鱼会新建一个叫做village_interfaces的功能包，并把所有ROS镇下的接口都定义在这个独立的功能包里。
有了功能包之后，我们就可以新建话题接口了，新建方法如下：
- 新建msg文件夹，并在文件夹下新建
xxx.msg - 在xxx.msg下编写消息内容并保存
- 在CmakeLists.txt添加依赖和msg文件目录
- 在package.xml中添加xxx.msg所需的依赖
- 编译功能包即可生成python与c++头文件
2.开始动手
2.1新建工作空间
在town_ws的src文件夹下，运行下面的指令，即可完成village_interfaces功能包的创建。
注意，这里包的编译类型我们使用ament_cmake方式。
ros2 pkg create village_interfaces --build-type ament_cmake
进入village_interfaces文件夹，使用tree指令查看，目录结构如下：
2.2 新建msg文件夹和Novel.msg(小说消息)
大家直接用vscode鼠标新建文件夹和新建文件就行，小鱼写个命令行装一下X
注意:msg文件开头首字母一定要大写，ROS2强制要求，原因小鱼盲猜应该是为了和类名保持一致
进入village_interfaces下，运行下面的命令：
cd village_interfaces
mkdir msg
touch Novel.msg
2.3编写Novel.msg内容
我们的目的是给李四的小说每一章增加一张图片，原来李四写小说是对外发布一个std_msgs/msg/String字符串类型的数据。
而发布图片的格式，我们需要采用ros自带的传感器消息接口中的图片sensor_msgs/msg/Image数据类型，所以我们新的消息文件的内容就是将两者合并，在ROS2中可以写做这样：
在msg文件中可以使用
#号添加注释。
# 标准消息接口std_msgs下的String类型
std_msgs/String content
# 图像消息，调用sensor_msgs下的Image类型
sensor_msgs/Image image
这种组合结构图如下：
这个图一共三层，第一层是消息定义层，第二层是ROS2已有的std_msgs,sensor_msgs，其组成关系是由下一层组合成上一层。
最下面一层string、uint8、uint32是ROS2中的原始数据类型，原始数据类型有下面几种，ROS2中所有的接口都是由这些原始数据类型组成。
bool
byte
char
float32,float64
int8,uint8
int16,uint16
int32,uint32
int64,uint64
string
2.3.1 另一种写法
除了上面一种写法外，还有一种编写方式，那就是采用ROS2的原始类型来组合。
其实很简单，我们不使用std_msgs/String 而是直接使用最下面一层的string。
结构图就变成了这样子：
graph
A[Novel.msg] -->C[sensor_msgs]
A[Novel.msg] -->G[Novel.msg]
C[sensor_msgs] -->G[string]
C[sensor_msgs/Image image] -->F[uint32]
C[sensor_msgs] -->E[uint8]
文件内容也变成了这样子：
# 直接使用ROS2原始的数据类型
string content
# 图像消息，调用sensor_msgs下的Image类型
sensor_msgs/Image image
2.3.2 说明
小鱼是如何知道，std_msgs/String是由基础数据类型string组成的，其实可以通过下面的指令来查看
ros2 interface show std_msgs/msg/String
结果如下：
string data
原来std_msgs的String就是包含一个叫变量名为data的string类型变量，这也是在4.2和4.3章节中代码要用.data才能拿到真正的数据的原因：
from std_msgs.msg import String
msg = String()
msg.data = '第%d回：潋滟湖 %d 次偶遇胡艳娘' % (self.i,self.i)
# msg 是 std_msgs.msg.String() 的对象
# msg.data data是string类型的对象，其定义是string data
2.3.3 两种写法选哪一种
小鱼这里选择第二种写法，让大家既了解ROS2的原始数据类型也了解ROS2自带的消息接口包。
所以最后我们的Novel.msg文件内容如下：
# 直接使用ROS2原始的数据类型
string content
# 图像消息，调用sensor_msgs下的Image类型
sensor_msgs/Image image
2.4 修改CMakeLists.txt
完成了代码的编写还不够，我们还需要在CMakeLists.txt中告诉编译器，你要给我把Novel.msg转换成Python库和C++的头文件。
大家直接添加下面的代码到CMakeLists.txt即可。
#添加对sensor_msgs的
find_package(sensor_msgs REQUIRED)
find_package(rosidl_default_generators REQUIRED)
#添加消息文件和依赖
rosidl_generate_interfaces(${PROJECT_NAME}
"msg/Novel.msg"
DEPENDENCIES sensor_msgs
)
find_package用于查找rosidl_default_generators位置，下面rosidl_generate_interfaces就是声明msg文件所属的工程名字、文件位置以及依赖DEPENDENCIES。
小鱼踩坑报告：重点强调一下依赖部分DEPENDENCIES，我们消息中用到的依赖这里必须写上，即使不写编译器也不会报错，直到运行的时候才会出错。
添加完成后的CMakeLists.txt长这样
2.5修改package.xml
修改village_interfaces目录下的package.xml，添加下面三行代码，为工程添加一下所需的依赖。
这里其实不添加也可以，小鱼后面会跟大家讲一下，packages.xml的作用。
<depend>sensor_msgs</depend>
<build_depend>rosidl_default_generators</build_depend>
<exec_depend>rosidl_default_runtime</exec_depend>
<member_of_group>rosidl_interface_packages</member_of_group>
添加完成后代码位置在这里。
2.6 编译
编译功能包相信大家都很熟悉了，小鱼就不多说了。
回到town_ws
colcon build --packages-select village_interfaces
3.验证
写好了自定义的消息，我们如何验证呢？
最好的办法肯定是写上一段代码来测试一下，但因为篇幅原因，小鱼把它放在了本章的最后。
所以我们本节可以通过上节课说过的ros2 interface常用的命令来测试。
source install/setup.bash
ros2 interface package village_interfaces #查看包下所有接口
ros2 interface show village_interfaces/msg/Novel #查看内容
ros2 interface proto village_interfaces/msg/Novel #显示属性
4.总结
我们可以在步骤3的运行结果中看到，Novel的消息内容是由content数据和传感器数据image共同组成的了。
通过本节学习，相信你已经学会如何自定义话题了，下一节和小鱼一起认识一下服务吧~
作者介绍：
我是小鱼，机器人领域资深玩家，现深圳某独脚兽机器人算法工程师一枚
初中学习编程，高中开始接触机器人，大学期间打机器人相关比赛实现月入2W+（比赛奖金）
目前在输出机器人学习指南、论文注解、工作经验，欢迎大家关注小智，一起交流技术，学习机器人