视觉与交互

目标：学会查看摄像头画面、开关人脸追踪、用手势指挥 LeLamp，并用语音拍照/录像

一、前提

✅ 摄像头已接好（教程 01）
✅ LeLamp 已开机联网（教程 02）
✅ 能打开 Web 仪表盘（教程 03）

本章所有"视觉"功能都依赖摄像头服务。如果仪表盘上看不到画面，先按第二节打开摄像头。

二、查看摄像头画面

第 1 步：打开仪表盘

浏览器访问 http://<LeLamp的IP>/dashboard。

第 2 步：打开摄像头（如无画面）

直接对 LeLamp 说：

"打开摄像头"

（等价于调用 toggle_vision(enabled=True)）

你应看到什么：仪表盘上的"视频画面"卡片出现实时画面；对着镜头挥挥手，画面同步变化。关闭时再说"关闭摄像头"。

仪表盘的视频画面是"开了视觉才有"——这也是人脸追踪、手势识别、拍照录像的总开关。

三、人脸追踪（开关与稳定性）

人脸追踪是什么

LeLamp 通过摄像头检测画面里的人脸，然后转头/点头看向你，并跟随你的移动缓缓转动——像一只好奇的小宠物。

开启与关闭

你说	效果
"打开面部追踪"	开启追踪（`toggle_face_tracking(true)`）
"关闭面部追踪"	停止追踪

你应看到什么：开启后站在镜头前，LeLamp 的头部转向你所在的方向；左右走动，它跟着转；离开画面后它慢慢回到原位。

追踪不稳/太灵敏怎么办

人脸追踪默认每 3 帧检测一次，并带平滑处理（EMA）。如果觉得不跟手，可以语音微调：

现象	调整方法
频繁丢失人脸、跟不上	说"把面部追踪灵敏度调高"；或换用 dnn 检测器："切换到 dnn 人脸检测"（`set_face_detector`）
画面卡顿、CPU 占用高	说"面部检测间隔调到 5"（`set_face_detect_interval`，数值越大越省 CPU）
误检（把东西当人脸）	在 `config.yaml` 中调高 `min_detection_confidence`（默认 0.6）

四、手势识别（8 种手势，其中 7 种静态 + 1 种动态）

LeLamp 能用摄像头识别你的手势并自动做出回应——你挥手，它挥手回礼；你竖大拇指，它亮绿灯。手势识别默认关闭，需要先打开：

"打开手势识别"

（等价于 toggle_gesture_recognition(true)；关闭说"关闭手势识别"）

灵敏度调节

你说	效果
"手势灵敏度调到高"	远距离/部分遮挡也能识别（可能误报）
"手势灵敏度调到中"	平衡模式（推荐默认）
"手势灵敏度调到低"	只识别非常清楚的手势，误报最少

8 种手势与反馈

站在摄像头前 0.5–2 米、光线充足的地方做手势：

手势	怎么做	LeLamp 的反应
挥手	手左右摆动	挥手臂回礼 + 暖黄闪光 + 问候
竖大拇指	只伸拇指，其他四指弯曲	绿色光晕 + 成功音效
指方向	只伸食指	头部转向你指的方向 + 青色扫描
停止	五指张开、手掌向前	电机冻结（变成可推动的"桌灯模式"），3 秒后自动恢复
V 字	食指+中指比 V	RGB 彩虹 2 秒
OK	拇指+食指成环	绿色光晕 + 确认音效
握拳	所有手指弯曲	灯光变暗（亮度 20%）
招手	五指张开、手掌向上	蓝色信标闪烁

其中挥手是动态手势（识别手的摆动轨迹），其余 7 种是静态手势。做手势时一次一个人效果最好——多人同时做，只响应第一个检测到的。

想看当前支持哪些手势、上次识别到什么，可以问："检查手势识别状态"（get_gesture_status）、"列出所有手势"（list_gestures）。

五、拍照与录像

不用按任何按钮，直接说就行：

拍照

"拍张照片"（也可说"拍照"、"拍一张"）

LeLamp 会从摄像头抓一帧存为 JPEG，并用语音告诉你保存路径。照片默认保存在：

~/.lelamp/photos/photo_20260801_103000.jpg   （按时间命名）

你应看到什么：LeLamp 语音回复"已拍照保存：/home/xxx/.lelamp/photos/photo_....jpg"。在终端执行 ls ~/.lelamp/photos 能看到新文件。

录像

"开始录像" → 录像开始（默认一直录，直到你说停） "录 10 秒" → 录像 10 秒后自动停止 "停止录像"（或"别录了"）→ 结束并保存

录像文件保存在：

~/.lelamp/videos/video_20260801_103000.mp4

你应看到什么：开始录像时 LeLamp 回复"开始录像，保存到：..."；停止时回复"录像已保存：...（X 帧，约 X 秒）"。

拍照/录像需要摄像头已有画面；如果回复"摄像头不可用"或"摄像头还没有画面"，先"打开摄像头"再试。

六、常见问题

问题	处理
手势做了没反应	① 确认说过"打开手势识别"；② 摄像头开着（"打开摄像头"）；③ 光线充足、距离 0.5–2 米；④ 说"手势灵敏度调到高"再试
画面卡顿	手势识别在 Pi 4 上约占 15–25% CPU：关掉手势识别、或调大面部检测间隔（"面部检测间隔调到 5"）
晚上识别不到手势	MediaPipe 依赖光照，给房间补光；夜间可优先用语音交互
追踪时头部乱转	误检导致，调高检测置信度（`min_detection_confidence` 0.6→0.7）或换 cascade 检测器
拍完照不知道存哪	LeLamp 会语音报路径；默认 `~/.lelamp/photos/`，录像在 `~/.lelamp/videos/`
拍照说"摄像头不可用"	先"打开摄像头"，等画面出现后再拍照

智能台灯LeLampX快速入门教程-视觉与交互