本项目是一个基于 Quectel Pi H1 单板电脑实现的手势识别远程视频控制示例。

系统通过摄像头采集手部图像，结合 AI 手势识别算法，实现隔空控制视频播放、进度与音量的自然交互体验。

开发资源汇总

开发配件清单

开发配件只是作为参考，不同的开发环境可能会有所差异，比如通过ssh远程连接进行开发，可以不使用usb拓展板，显示屏也可以根据需要进行替换。

配件名称	数量	规格参数
Quectel Pi H1 智能主控板	1块	Quectel Pi H1智能生态开发板
USB-C 电源线充电器	1个	27W USB Type-C接口充电器 1.2米线长中规电源PD电源 适用于树莓派5代
HDMI 线	1根	规格：HDMI 2.0；线长：1m；接口：HDMI-A（公头）-HDMI-D（公头）
网线	1根	线长：1m；传输速率：千兆；
CPU 散热风扇	1个	树莓派5代官方原装散热器带导热贴
2PIN PH1.25接口喇叭	1个	2030腔体喇叭8Ω 2W方形喇叭高音质小体积扬声器 2PIN PH1.25接口
扩展坞	1个	绿联 USB3.0扩展器扩展坞
USB摄像头模块	1个	OV5693 USB摄像头模块
显示屏	1个	24英寸HDMI显示器

配件实物参考

快速上手

开发准备

Quectel Pi H1单板电脑出厂默认搭载 Debian 13 系统镜像，因此无需再次烧录镜像，仅需按照如下步骤操作即可。

硬件连接

散热风扇安装

先将散热风扇的排线插入单板电脑的FAN插槽中，然后将散热器上的两端固定在单板电脑预留的插孔中，如下：

显示连接

将 HDMI 线一端接入单板电脑的 HDMI 接口，另一端接入显示器的 HDMI 接口。

输入设备连接

将 USB 键盘、鼠标接入扩展坞的USB接口，再将扩展坞接入单板电脑的USB接口，若用无线输入设备，将接收器插入扩展坞的USB口即可。

#### **网络连接**

将网线一端接入单板电脑的千兆网口，另一端接入路由器的网口（确保路由器已联网）。

跳线帽连接

单板电脑左上角标有AUTO_POWER_ON丝印的排针，确保已经用跳线帽短接。

供电连接

将 USB-A 电源线的 USB-A 端接入电源适配器，USB-C 端接入单板电脑的电源口（通常标注POWER IN）。

扬声器连接

将2PIN PH1.25接口的喇叭连接到单板电脑的SPK插槽中。

摄像头连接

将OV5693摄像头模块接入单板电脑的USB接口即可。

连接完成参考

项目实现

安装ffmpeg

sudo apt update
sudo apt install -y ffmpeg

配置python环境

目前系统默认的python版本为3.13，而我们使用的MediaPipe模型需要的开发环境在python3.9-3.12，需要重新指定python路径，系统中已经安装了python3.10，我们修改python默认路径即可。

# 切换到python3.10版本
sudo cp /usr/bin/python3 /usr/bin/python3.backup
sudo rm /usr/bin/python3
sudo ln -s /usr/bin/python3.10 /usr/bin/python3
# 安装pip并更新
python3 -m ensurepip --upgrade
pip install --upgrade pip

下载demo示例代码

1.点击下载代码
2.利用scp命令上传文件到gesture-remote-control文件夹下,参考远程访问SCP文件拷贝章节
3.解压文件到本地目录

tar -xzvf gesture-remote-control.tar.gz

安装项目所需库

进入gesture-remote-control目录下执行以下命令安装项目所需库

pip install -r requirements.txt

运行程序

在gesture-remote-control文件夹下执行main.py程序启动脚本。

支持的手势映射

请确保摄像头正对用户操作区域，并具备稳定光照条件。

手势动作	控制功能
张开手掌（5 指）	播放 / 暂停
手指向右滑动	快进 5 秒
手指向左滑动	快退 5 秒
手指向上滑动	音量 +5%
手指向下滑动	音量 -5%

应用演示

家庭影院

NPU应用