V2-K

V2-K 双目自由角度视觉位移计 API 参考手册

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

V2-K 是双目固定式视觉位移计，双视觉传感器可独立调整角度，适用于需要灵活监测角度的场景。

与 V2-W 的区别： V2-K 双视觉传感器可朝向不同方向，因此各标靶距离可能不同。

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-K 双视觉传感器可朝向不同方向，因此各标靶距离可能不同。

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	是否跳过测量