最近在学习opencv的物体跟踪模块,写了一个小项目练手:打开摄像头,按s键用鼠标框选一个物体,程序就会自动跟随它的移动。代码虽然简单,但涵盖了物体跟踪的核心流程,还处理了opencv不同版本的兼容性、跟踪重置、丢失提示等细节。本文作为学习笔记,分享完整代码和关键知识点。
一、物体跟踪是什么?
物体跟踪(object tracking)是指在视频序列中,持续定位一个预先选定的目标。它与物体检测的区别在于:
- 检测:每一帧都独立找出所有物体,计算量大,但能处理任意目标。
- 跟踪:只在第一帧指定目标,后续帧利用时间连续性快速预测位置,实时性高。
opencv提供了多种跟踪算法,如kcf、csrt、mosse等。本文使用kcf(kernelized correlation filters),它在速度和精度之间取得较好平衡,适合实时应用。
二、环境准备
- python 3.x
- opencv库(含
contrib模块)
安装命令:
pip install opencv-python opencv-contrib-python
注意:从opencv 4.5.1开始,部分跟踪器被移入
cv2.legacy子模块。本文代码已做兼容处理。
三、完整代码
以下代码实现了:
- 打开默认摄像头
- 按
s键框选目标并开始跟踪 - 按
r键重置跟踪(可重新选目标) - 跟踪失败时显示“tracking lost”提示
- 按
esc键退出
import cv2
# ----- 兼容不同opencv版本的跟踪器创建 -----
try:
# 适用于 opencv < 4.5.1
tracker = cv2.trackerkcf_create()
except attributeerror:
# 适用于 opencv >= 4.5.1
tracker = cv2.legacy.trackerkcf_create()
tracking = false # 是否处于跟踪状态
cap = cv2.videocapture(0) # 0 为默认摄像头
# 检查摄像头是否打开成功
if not cap.isopened():
print("错误:无法打开摄像头")
exit()
while true:
ret, frame = cap.read()
if not ret:
print("无法读取帧")
break
key = cv2.waitkey(1)
# ----- 按 s 键:选择目标并开始/重置跟踪 -----
if key == ord('s'):
tracking = false # 先重置状态
roi = cv2.selectroi("tracking", frame, false)
# 如果用户取消了选择(roi为(0,0,0,0)),则不进行初始化
if roi != (0, 0, 0, 0):
# 重新创建跟踪器,清除旧状态
try:
tracker = cv2.trackerkcf_create()
except attributeerror:
tracker = cv2.legacy.trackerkcf_create()
tracker.init(frame, roi)
tracking = true
# ----- 按 r 键:重置跟踪(不选新目标,只是停止) -----
elif key == ord('r'):
tracking = false
print("跟踪已重置,请按 s 选择新目标")
# ----- 如果处于跟踪状态,更新跟踪器并绘制结果 -----
if tracking:
success, box = tracker.update(frame)
if success:
x, y, w, h = [int(v) for v in box]
cv2.rectangle(frame, (x, y), (x+w, y+h), (0, 255, 0), 2)
else:
# 跟踪失败时显示文字提示
cv2.puttext(frame, "tracking lost", (50, 50),
cv2.font_hershey_simplex, 1, (0, 0, 255), 2)
cv2.imshow("tracking", frame)
# 按 esc 退出
if key == 27:
break
cap.release()
cv2.destroyallwindows()四、代码详解
1. 创建跟踪器(兼容性写法)
try:
tracker = cv2.trackerkcf_create()
except attributeerror:
tracker = cv2.legacy.trackerkcf_create()- 旧版opencv中
trackerkcf_create直接在cv2下;新版移到了cv2.legacy。 - 用
try-except捕获attributeerror,自动选择正确的创建方式,避免因版本差异而报错。
2. 选择目标:cv2.selectroi()
roi = cv2.selectroi("tracking", frame, false)- 弹出一个窗口,用户用鼠标框选感兴趣区域(roi)。
- 返回值
roi = (x, y, w, h)是矩形框的位置和大小。 - 第三个参数
false表示从左上角拖到右下角画矩形(true表示从中心点画)。
3. 初始化跟踪器:tracker.init(frame, roi)
- 用选定的第一帧图像和roi初始化跟踪器内部模型。
- 必须在调用
update()之前调用,且只在目标选定或重新选择时调用一次。
4. 更新跟踪:tracker.update(frame)
- 对每一帧调用,返回
(success, box)。 success为true表示跟踪成功,box是新的目标矩形;否则为false。
5. 交互控制
s键:重置tracking标志,弹出选择框,重新初始化跟踪器。r键:仅重置tracking标志,不选新目标(方便停止跟踪)。esc键:退出循环。
6. 跟踪失败提示
当success == false时,用cv2.puttext()在画面左上角显示红色“tracking lost”,让用户知道已跟丢。
五、运行方法
- 将上述代码保存为
object_tracking.py。
在终端运行:
python object_tracking.py
摄像头打开后:
- 按下键盘
s键,画面会冻结并出现“tracking”窗口。 - 用鼠标拖拽框选要跟踪的物体(例如你的手、一本书等)。
- 按回车或空格确认选择。
- 程序开始自动跟踪,绿色框会跟随物体移动。
- 如果跟丢,画面显示“tracking lost”,可按
r重置,再按s重新选择。
按 esc 退出程序。
六、效果展示

- 跟踪成功时,绿色矩形框会紧贴目标移动(即使目标在画面中旋转、稍微变形,kcf仍有一定鲁棒性)。
- 如果目标快速移动或被遮挡,跟踪可能会失败(出现红色文字),此时需要重新选择目标。
提示:为了获得更好的跟踪效果,可以尝试将kcf换成csrt(更准但稍慢):
tracker = cv2.legacy.trackercsrt_create()
七、常见问题
q1:运行时报错 attributeerror: module 'cv2' has no attribute 'trackerkcf_create'
a:说明你的opencv版本较新(≥4.5.1)。代码中的try-except已经处理了这种情况,请确保你完整复制了兼容性写法。如果仍然报错,请检查是否安装了opencv-contrib-python。
q2:为什么跟踪一段时间后框会飘走?
a:kcf对遮挡、尺度变化、快速运动比较敏感。可以尝试换用csrt算法,或者重新按s框选目标。
q3:如何跟踪视频文件而不是摄像头?
a:将cv2.videocapture(0)改为视频路径,例如cv2.videocapture("test.mp4")。
q4:selectroi弹出的窗口怎么关闭?
a:确认选择后按enter或空格,窗口会自动关闭。如果不想选择,按esc取消。
八、总结
通过这个小项目,你可以掌握:
- opencv物体跟踪的基本流程:创建跟踪器 → 选择roi → 初始化 → 逐帧更新。
- 处理不同opencv版本的兼容性问题。
- 增加交互逻辑(重置、失败提示)提升用户体验。
物体跟踪是计算机视觉中非常实用的技术,可以应用于自动驾驶、安防监控、人机交互等领域。希望这篇笔记能帮助你快速上手,自己动手试一试吧!
下一步学习建议:
- 尝试使用
csrt或mosse算法,比较精度和速度。 - 学习多目标跟踪(mot),同时跟踪多个物体。
- 结合yolo等目标检测器,实现自动检测+跟踪。
以上就是python使用opencv实现物体跟踪的实践方法的详细内容,更多关于python opencv物体跟踪的资料请关注代码网其它相关文章!
发表评论