集成应用场景:
无 ROS 平台的受控 HTTP 桥 受控 HTTP 桥示例位于可导入包 examples.platform_bridge,用于为无 ROS 环境的平台提供 HTTP 到 ROS2 的实机闭环入口,当前覆盖录制 Service 的转换,并内置以下安全边界:
交付包说明
本页面引用的 examples/ 脚本请通过正式交付渠道提供的交付包获取,并使用与软件版本匹配的交付包版本;文档中的路径仅用于说明脚本结构。
- 启动必须提供非空
REALBOT_BRIDGE_TOKEN;三个端点都要求完全匹配的Authorization: Bearer <token>。 - 默认只绑定
127.0.0.1:8090;非 loopback 绑定必须显式承认“只在机器人私有 LAN”。 - POST 必须声明 1~65536 字节的十进制
Content-Length,字节数必须与请求体一致。 - 元数据只允许
scene/task/operator/device四个字段,每项 1~128 字符,交付示例限定为 ASCII 字母、数字、点、下划线和连字符;拒绝未知字段、路径分隔符和控制字符。 start/stop通过同一个进程内锁串行。该锁不能阻止其他 ROS2 客户端或第二个桥进程并发调用,生产平台仍必须有机器人级唯一控制权。list只返回配置录制根目录的直接、非符号链接目录名;不提供文件读取或删除端点。- 访问日志只记录方法、固定路径和状态码,不记录
Authorization头、token 或请求体。
| 方法 | 路径 | 请求体 | 成功返回 |
|---|---|---|---|
| POST | /record/start | 严格四字段 JSON | 录制器的 status: 0 JSON |
| POST | /record/stop | 与 start 相同的四字段 JSON | 录制器的 status: 0 JSON |
| GET | /record/list | 无 | recordings 目录名数组 |

