定位

目标跟踪

跨帧关联检测点形成连续轨迹，输出稳定编号、平滑位置与持续帧数，用于目标计数
TargetTrack · v1.0 · by system

名称	keyId	类型	默认值	可连接	说明
目标X	`targetX`	vec_double	[]	是	当前帧各检测目标的 X 坐标列表，与 targetY 等长；为空或长度不一致会导致运行失败
目标Y	`targetY`	vec_double	[]	是	当前帧各检测目标的 Y 坐标列表，与 targetX 逐一对应同一批目标；缺失时返回 -1
置信度	`targetScore`	vec_double	[]	是	当前帧各检测目标的置信度列表，与 targetX、targetY 等长并按同一顺序逐点对应
跟踪窗口	`trackWindow`	int	5	否	位置平滑的滑动窗口帧数，默认 5；小于等于 0 时按 1 处理，即直接输出当前帧位置
最大速度	`maxSpeed`	double	100	否	单帧允许的最大移动距离，默认 100 像素；超过该距离的目标不会被关联到已有轨迹

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=成功，已输出本帧各轨迹的状态；-1=缺少目标坐标或坐标数据无效，此时不产出轨迹
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时给出具体原因（缺少输入数据或数据无效），便于排查连线
跟踪数	`trackCount`	int	—	否	本帧输出的轨迹总数，等于持续跟踪的旧轨迹与新生成轨迹之和
跟踪ID	`trackId`	vec_int	—	否	每条轨迹的整数编号，新目标按出现顺序递增分配，旧轨迹保持原编号不变
跟踪X	`trackX`	vec_double	—	否	每条轨迹平滑后的 X 坐标，取最近若干帧位置的平均值，新轨迹首帧为原始坐标
跟踪Y	`trackY`	vec_double	—	否	每条轨迹平滑后的 Y 坐标，取最近若干帧位置的平均值，新轨迹首帧为原始坐标
持续帧数	`frameCount`	vec_int	—	否	每条轨迹已连续关联到的帧数，成功匹配一帧加一，新轨迹从 1 开始计数

在 FlowDesigner 中将「目标跟踪」节点加入流程画布，把上游图像或数据连接至「目标X」，并将「运行结果」接至下游节点。运行后可通过 VisionQuick 的数据绑定将结果呈现在界面组件上。

完整操作步骤参见使用文档；安装与使用问题可通过联系页反馈。

联系与反馈

获取安装包与技术反馈

安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。

微信扫码 · 安装包与问题反馈