O1

O1 单目单轴旋转式视觉位移计 API 参考手册

型号: O1 | 版本: 1.0 | 更新: 2026-09-11

O1 是单目单轴旋转式视觉位移计，支持水平方向云台控制和巡航。

1. 快速开始

方法	说明
`getCruisePaths`	获取巡航路径

标靶管理 API 的完整字段约束参考 API参考。

对指定标靶执行参考位置初始化/标定。通常先通过 addTargets 或 setTargets 保存标靶配置；初始化时可只传 targetId。如需覆盖保存配置，可在本次请求中提供 roi、distance 或 targetModel。

在已有标靶基础上添加新标靶。

获取当前标靶列表。

响应字段：

字段	类型	说明
`targets[].targetId`	String	标靶 ID，1-64 字节，非空，不包含控制字符
`targets[].sensorId`	Integer	视觉传感器 ID，单目设备为 `0`
`targets[].roi`	Object	标靶 ROI 区域
`targets[].distance`	Float	测量距离，单位 m
`targets[].role`	String	标靶角色：`MP` 为被测点，`RP` 为稳定基准点，`CP` 为控制/校核点
`targets[].targetModel`	String	标靶型号，取值 `T10`、`T20`、`T50`、`T100`、`T200`
`targets[].skipMeasurement`	Boolean	是否跳过测量

更新已有标靶的配置。

删除指定标靶。

设置电机角度。

注意： O1 仅支持水平 (pan) 方向，不支持 tilt 参数。

参数：

字段	类型	范围	说明
`pan`	Float	-180 ~ 180	水平角度 (°)
`speed`	Integer	1-100	转动速度 (%)

请求：

{"reqId": 1, "method": "setMotorAngle", "params": {"pan": 45.0, "speed": 50}}

获取当前电机角度。

请求：

{"reqId": 1, "method": "getMotorAngle", "params": {}}

响应：

{"reqId": 1, "code": 0, "data": {"pan": 45.0}}

设备通过 vdm/{deviceId}/telemetry 上报位移和设备状态；环境字段按设备传感器能力提供。字段、单位及 Protobuf / JSON 示例见遥测数据。