# 眼睛遥控器

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

本项目基于Quectel Pi M2智能主控板开发，充分利用其强大的计算能力和多媒体处理能力，实现了低延迟、较高准确率的眼部追踪功能。

眼睛遥控器是一个智能控制系统，通过检测用户眼部状态来控制视频播放：注视屏幕时继续播放，闭眼或离开屏幕时自动暂停。

核心功能：

- 当检测到用户眼睛睁开并注视屏幕时，系统会自动播放或保持视频播放状态。

- 当检测到用户闭眼、转移视线或离开屏幕时，系统会立即暂停当前播放的视频。

```{image} images/image_FL5ubeZyLojkITxb78tcJtzOnKh.webp
:width: 1280px
:height: 800px
:align: center
```

# 开发资源汇总

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

## 开发配件清单

```{note}
```

| <div style="text-align: center"><br><strong>配件名称</strong><br></div> | <div style="text-align: center"><br><strong>数量</strong><br></div> | <div style="text-align: center"><br><strong>规格参数</strong><br></div> |
| --- | --- | --- |
| Quectel Pi M2智能主控板 | <div style="text-align: center"><br>1块<br></div> | <div style="text-align: center"><br>-<br></div> |
| USB-C电源线充电器 | <div style="text-align: center"><br>1个<br></div> | <div style="text-align: center"><br><a href="https://www.waveshare.net/shop/PSU-27W-USB-C-CN-B.htm">27W USB Type-C接口充电器1.2米线长中规电源PD电源适用于树莓派5代</a><br></div> |
| HDMI A 型对公线 | <div style="text-align: center"><br>1根<br></div> | HDMI 2.0；线长1 m；接口：HDMI-A（公头）-HDMI-A（公头） |
| 网线 | <div style="text-align: center"><br>1根<br></div> | <div style="text-align: center"><br>线长：1m；传输速率：千兆；<br></div> |
| USB摄像头模块 | <div style="text-align: center"><br>1个<br></div> | <div style="text-align: center"><br><a href="https://mobile.yangkeduo.com/goods2.html?refer_share_uin=HC2HZHBRDNNPFIW6QCZEW2XQ4A_GEXDA&_oak_share_time=1787119415&share_uin=HC2HZHBRDNNPFIW6QCZEW2XQ4A_GEXDA&page_from=101&refer_share_id=y4sTkpPRlAHY96qyJFHFFnJNwjWQV7zP&refer_share_channel=copy_link&share_oak_rcto=YWJ8p2lmIDdK7Lo0ARoAAgaJ68JNvxNplRZIxPZDmMYzICas-VukTOVMR5RxeMFtrlmCftIQ9CUjGg&_oak_share_snapshot_num=7990&pxq_secret_key=5YWGLZQM4S7QGXHMIEKYBJJJDU3DB4MPY2FAHYEUQKEQO2YB5EAA&goods_id=817946711252&uin=HC2HZHBRDNNPFIW6QCZEW2XQ4A_GEXDA">绿联高清USB摄像头带麦克风(2K 400万高清自动对焦）</a><br></div> |
| 显示屏 | <div style="text-align: center"><br>1个<br></div> | <div style="text-align: center"><br>24英寸HDMI显示器<br></div> |

## 配件实物参考

```{image} images/image_CiUMb3Et1oTsi7xIiKYcA5RRnbe.webp
:width: 980px
:height: 624px
:align: center
```

# 快速上手

## 开发准备

**Quectel Pi M2** 智能主控板出厂默认搭载 **Debian 13** 系统镜像，因此无需再次烧录镜像，仅需按照如下步骤操作即可。

## 硬件连接

完成以下所有硬件连接操作，序号与接口示意图保持一致：

```{image} images/image_TM59b9PyHoByGgxNqpNctoaTnHf.webp
:width: 627px
:height: 463px
:align: center
```

1. **显示连接:** 需根据显示器的接口选择连接方案，这里采用方案二；将Micro HDMI 线一端接主控板 Micro HDMI 接口，另一端接显示器 HDMI 接口；  
    - 方案1（高清）：将 **FPC** 排线一端接入 **Quectel Pi M2** 的 **MIPI** 接口，另一端接入显示器的 **MIPI** 接口, 具体细节参考 [MIPI](<../../../使用指南/显示/MIPI/MIPI.md>)。  
    - 方案2（兼容）：将 **HDMI** 线一端接入 **Quectel Pi M2** 的 **HDMI** 接口，另一端接入显示器的 **HDMI** 接口。

2. **网络连接**: 用网线连接 **Quectel Pi M2** 网口和路由器的 **LAN** 口即可。

3. **外设连接**: 将USB键盘、鼠标、USB摄像头接入 **Quectel Pi M2** 的 **USB-A** 接口上；若用无线键鼠，将接收器插入 **USB** 口即可。

4. **供电连接**：最后将 **USB-A** 电源线的 **USB-A** 端接入电源适配器，**USB-C** 端接入 **Quectel Pi M2** 的电源口。

```{note}
```

## 项目实现

1. 在智能主控板上打开终端，使用git克隆项目代码。

```bash
sudo apt update
sudo apt install -y git
git clone https://github.com/Quectel-Pi/demo-eye-remote-control.git
```

执行完成后，当前目录下应生成 *demo-eye-remote-control* 文件夹。

2. 在智能主控板的终端下依次执行下面命令，终端显示 *Deployment complete* 则说明部署完成。

```bash
cd demo-eye-remote-control
sudo chmod 755 install.sh
./install.sh
```

如果执行 *./install.sh* 过程中报错，或终端未显示"Deployment complete"，请先不要继续执行后续步骤。建议先确认网络连接正常，再返回项目根目录重新执行一次 *install.sh*。

3. 重新打开终端，验证Python版本，输出 *Python 3.10.15* 则表示安装成功。

```bash
python3 --version
```

### 运行程序

在 *demo-eye-remote-control* 路径下执行 *./start.sh* 启动脚本。

```bash
cd demo-eye-remote-control/
./start.sh
```

# 使用说明

## 基本操作流程

1. **启动程序**: 程序启动后会自动开启摄像头并开始检测。

2. **加载视频**: 点击"选择视频文件"按钮加载想要播放的视频。

3. **开始观看**: 系统会根据您的视线状态自动控制播放/暂停。

4. **切换模式**: 可使用全屏播放模式获得更好的观看体验。

## 界面功能说明

- **全屏模式**: 点击"F11"或界面上的全屏按钮进入全屏化界面。

- **全屏播放模式**: 全屏播放视频，并根据实时识别结果控制视频播放。

- **摄像头开关**: 可随时开启或关闭摄像头。

- **检测开关**: 可手动启用或禁用眼部检测功能。

- **标记点显示**: 可视化显示眼部关键点和检测结果。

## 控制逻辑详解

| <div style="text-align: center"><br><strong>状态</strong><br></div> | <div style="text-align: center"><br><strong>行为</strong><br></div> | <div style="text-align: center"><br><strong>说明</strong><br></div> |
| --- | --- | --- |
| <div style="text-align: center"><br>注视屏幕 + 眼睛睁开<br></div> | <div style="text-align: center"><br>继续播放<br></div> | <div style="text-align: center"><br>系统检测到您正在观看<br></div> |
| <div style="text-align: center"><br>闭眼或视线移开<br></div> | <div style="text-align: center"><br>自动暂停<br></div> | <div style="text-align: center"><br>离开或闭眼时暂停播放<br></div> |
| <div style="text-align: center"><br>人脸离开摄像头<br></div> | <div style="text-align: center"><br>自动暂停<br></div> | <div style="text-align: center"><br>超过1秒未检测到人脸<br></div> |

# 常见问题及解决方案

## 摄像头无法识别

**现象：**

```plaintext
No available camera device found
```

**解决方案：**

- 检查摄像头是否正确连接到USB接口。

- 使用命令检查摄像头是否被识别：

```shell
ls -la /dev/video*
```

- 尝试使用其他USB接口。

- 如果还是不行，使用USB集线器并连接电源。

- 重新插拔USB摄像头。

## 运行main.py提示No module named cv2

**现象：**

```plaintext
ModuleNotFoundError: No module named 'cv2'
```

**解决方案：**

该问题通常表示 *install.sh* 未安装成功，请先返回项目根目录重新执行安装脚本：

```bash
cd demo-eye-remote-control
./install.sh
```

# 应用演示

<div class="video-preview">
  <video width="100%" controls preload="none">
    <source src="videos/video_WBcDb7r3ZoWKtzxXD34c7EKPnHg.mp4" type="video/mp4">
    Your browser does not support the video tag.
  </video>
  <div class="video-caption">
    <strong>eye_remote_control_zh</strong>
  </div>
</div>


# 技术支持与贡献

如在使用过程中遇到问题，欢迎在 [移远官方论坛](<https://forumschinese.quectel.com/t/topic/12199>) 提交技术咨询，我们的技术支持团队将及时为您解答。

项目开源地址：[https://github.com/Quectel-Pi/demo-eye-remote-control](<https://github.com/Quectel-Pi/demo-eye-remote-control>)

欢迎提交Issue反馈问题或Pull Request贡献代码改进！