Python SDK#

安装统一 robobaton_sdk,直接订阅公开 HTTP,不复制 RBH1 解析实现。

获取与运行#

先在 统一 SDK 接入 下载并解压 SDK,在包含 SDK/ 的目录使用 Python 3.8+:

python3 -m pip install -e SDK/python
python3 SDK/python/examples/odometry.py http://192.168.11.1 --messages 10
python3 SDK/python/examples/odometry.py http://192.168.11.1 --channel imu

Windows 可将 python3 替换为 py -3。核心客户端仅依赖标准库;不安装时可把 SDK/python 加入 PYTHONPATH,再运行同一示例。系统禁止全局 pip 安装时使用自己的虚拟环境,不强制修改系统 Python。

接入自己的程序#

SDK 包公开入口,直接来自本次源码快照#
from .client import Device

__all__ = ['Device']
from robobaton_sdk import Device

stream = Device('http://192.168.11.1').observe(['odometry'])
try:
    for name, fmt, sequence, message in stream:
        if name == 'odometry':
            print(message['header'], message['pose'], message['twist'])
finally:
    stream.close()

每个连接只选择一个通道:odometry、imu、preview、color、gray、gray_jpeg 或 depth。 同时需要多个通道时分别创建连接,不把到达顺序当同步关系。图像 data 是二进制,不直接按 JSON 打印像素。 Device 也保留公开管理方法;本页接收示例不调用写接口,写操作应另读 HTTP API 接入 的幂等和并发规则。

完整位姿 / IMU 示例#

直接来自 SDK/python/examples/odometry.py#
import argparse
import json

from robobaton_sdk import Device


def main():
    parser = argparse.ArgumentParser(description='只读订阅 Neo HTTP 数据')
    parser.add_argument('origin', nargs='?', default='http://192.168.11.1')
    parser.add_argument('--channel', choices=['odometry', 'imu'], default='odometry')
    parser.add_argument('--messages', type=int, default=10)
    args = parser.parse_args()
    if args.messages < 1:
        parser.error('--messages 必须大于 0')
    stream = Device(args.origin).observe([args.channel])
    remaining = args.messages
    try:
        for name, fmt, sequence, message in stream:
            if name == 'control':
                continue
            print(json.dumps(message, ensure_ascii=False))
            remaining -= 1
            if remaining == 0:
                break
        if remaining:
            raise ConnectionError('数据流提前结束,请检查设备后重新建立会话')
    finally:
        stream.close()


if __name__ == '__main__':
    main()

获取与保存图像#

mkdir -p tmp/neo-images
python3 SDK/python/examples/image.py http://192.168.11.1 tmp/neo-images --messages 10
直接来自 SDK/python/examples/image.py#
import argparse
import json
from pathlib import Path

from robobaton_sdk import Device


def main():
    parser = argparse.ArgumentParser(description='Save public gray JPEG frames and source metadata')
    parser.add_argument('origin')
    parser.add_argument('directory', type=Path)
    parser.add_argument('--messages', type=int, default=10)
    args = parser.parse_args()
    if args.messages < 1 or not args.directory.is_dir():
        parser.error('Use a positive message count and an existing output directory')
    stream = Device(args.origin).observe(['gray_jpeg'])
    received = 0
    try:
        for name, fmt, sequence, sample in stream:
            if name != 'gray_jpeg':
                continue
            path = args.directory / (str(sequence) + '.jpg')
            sidecar = args.directory / (str(sequence) + '.json')
            if path.exists() or sidecar.exists():
                raise FileExistsError('Use a fresh output directory')
            with path.open('xb') as output:
                output.write(sample['data'])
            metadata = {key: value for key, value in sample.items() if key != 'data'}
            with sidecar.open('x', encoding='utf-8') as output:
                json.dump(metadata, output, separators=(',', ':'))
            print(path)
            received += 1
            if received >= args.messages:
                return
        raise ConnectionError('Image stream ended before requested frame count')
    finally:
        stream.close()


if __name__ == '__main__':
    main()

每帧保存 JPEG 与同名 JSON,拒绝覆盖已有文件;文件名采用 RBH1 消息序号。 JSON 保留原设备 header 与配置。gray_jpeg 为 544×640 mono8、质量90、源帧率模式, 不承诺固定频率。此示例不完整解码 JPEG;位姿与图像独立连接,不自动同步配对。 设备时间为开机单调时间或 null,不是 UTC;相机光学系不同于 IMU 系。

输出与失败处理#

默认收 10 条业务消息,control 元数据不计数。null 位姿仍原样输出,不代表有效定位; 若想收齐有效位姿与图像,使用 Python 快速验证 的快速验证。 连接错误、协议错误或未收够消息就结束会退出,不自动重连;finally 释放订阅。 时间、坐标和空值约定见 统一 SDK 接入。收到数据不代表标定精度通过。