V2-W

V2-W 双目固定式视觉位移计 API 参考手册

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

V2-W 系列是双目固定式视觉位移计，支持双视觉传感器同步测量。配合另一台设备可实现 3D 空间位移融合计算。

1. 快速开始

2. API 列表

基础 API

方法	说明
`getAttr`	获取属性
`setAttr`	设置属性
`reboot`	重启设备
`syncTime`	同步时间

标靶管理 API

方法	说明
`initRefTargets`	初始化标靶参考位置
`addTargets`	添加标靶
`getTargets`	获取标靶列表
`setTargets`	更新标靶配置
`deleteTargets`	删除标靶

测量控制 API

方法	说明
`startMeasurement`	启动测量
`stopMeasurement`	停止测量
`setLightLevel`	设置补光灯发光挡位
`getLightLevel`	获取补光灯发光挡位
`snapshot`	获取快照

3. API 详情

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

initRefTargets

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

参数：

字段	类型	必填	说明
`targets`	Array	是	要初始化标靶参考位置的标靶数组，不能为空
`targets[].targetId`	String	是	标靶 ID，1-64 字节，非空，不包含控制字符
`targets[].sensorId`	Integer	否	视觉传感器 ID (0 或 1)；不传时使用已保存标靶配置
`targets[].roi`	Object	否	ROI 区域；不传时使用已保存标靶配置
`targets[].distance`	Float	否	测量距离 (m)；不传时使用已保存标靶配置
`targets[].targetModel`	String	否	标靶型号，取值 `T10`、`T20`、`T50`、`T100`、`T200`

注意： V2-W 4M 分辨率为 2560×1440，ROI 坐标需相应调整。

Protobuf / JSON 示例。

addTargets

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

Protobuf / JSON 示例。

getTargets

获取当前标靶列表。

响应字段：

字段	类型	说明
`targets[].targetId`	String	标靶 ID，1-64 字节，非空，不包含控制字符
`targets[].sensorId`	Integer	视觉传感器 ID，双目设备为 `0` 或 `1`
`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	是否跳过测量