Mediapipe FaceLandmark Demo 项目启动与配置教程

1. 项目目录结构及介绍

该项目是基于开源框架 Mediapipe 实现的人脸关键点检测的演示项目。以下是项目的目录结构及各部分的作用：

mediapipe-facelandmark-demo/
├── app.py               # 项目启动脚本
├── assets/              # 存放项目所需的资源文件，如图片、模型文件等
│   ├── face_landmark.tflite
│   ├── irises.tflite
│   └── ...
├── config/              # 配置文件目录
│   └── settings.py      # 配置参数文件
├── dist/                # 打包后的项目文件
├── models/              # 模型文件存放目录
├── requirements.txt     # 项目依赖文件
└── templates/           # HTML模板文件目录
    ├── index.html
    └── ...

• app.py：Python 脚本，用于启动和运行 Flask 应用程序。
• assets/：资源文件目录，包括用于人脸关键点检测的预训练模型文件等。
• config/：配置文件目录，包含项目的配置信息。
• dist/：项目打包后的文件存放目录。
• models/：模型文件存放目录，用于存放可能需要的其他模型文件。
• requirements.txt：项目依赖文件，列出了运行项目所需的 Python 包。
• templates/：HTML模板文件目录，包含项目的网页模板。

2. 项目的启动文件介绍

项目的启动文件为 app.py。以下是该文件的简要介绍：

app.py 是一个 Flask 应用程序，它定义了应用的入口点，并设置了路由以处理客户端的请求。主要部分如下：

from flask import Flask, render_template

app = Flask(__name__)

@app.route('/')
def index():
    return render_template('index.html')

if __name__ == '__main__':
    app.run(debug=True)

该脚本首先从 flask 模块导入所需的类和函数，然后创建一个 Flask 应用实例。通过 @app.route('/') 装饰器，定义了当用户访问根路径时应当调用的函数 index，该函数会渲染 index.html 模板文件。

最后，如果该脚本作为主程序运行（不是作为模块导入），则会启动 Flask 应用程序，开启调试模式。

3. 项目的配置文件介绍

项目的配置文件位于 config/settings.py。该文件中定义了项目运行时所需的各项配置参数。以下是一个配置文件的示例：

# config/settings.py

# Flask 应用配置
FLASK_SERVER_HOST = '0.0.0.0'
FLASK_SERVER_PORT = 5000
FLASK_DEBUG = True

# Mediapipe 模型路径配置
FACE_LANDMARK_MODEL_PATH = 'assets/face_landmark.tflite'
IRISES_MODEL_PATH = 'assets/irises.tflite'

在这个配置文件中，定义了 Flask 服务的监听地址和端口，以及调试模式是否开启。此外，还定义了 Mediapipe 模型文件的存储路径，这样在程序中就可以通过这些路径来加载模型。

通过以上三个模块的介绍，您应该可以顺利启动和配置 mediapipe-facelandmark-demo 项目。在开始之前，请确保已经安装了所有必要的依赖项，并且正确设置了配置文件。