MediaPipe 跨平台实时视觉环境安装完整指南:四步跑通 Hello World MediaPipe 跨平台实时视觉环境安装完整指南四步跑通 Hello World【免费下载链接】mediapipeCross-platform, customizable ML solutions for live and streaming media.项目地址: https://gitcode.com/GitHub_Trending/med/mediapipe在需要接入人脸检测、手势识别等实时视觉能力的项目里MediaPipe 环境配置往往是最容易卡住的一步。这篇文章把源码获取、Bazel 构建、运行验证的完整链路走一遍让你一次跑通第一个示例程序。 上手前自检构建失败大多出在环境前置条件上花一分钟确认以下条目能省下大量排查时间。必需项操作系统Linux、macOS、Windows 任选其一工具链Git、Bazel 6.5.0 及以上或 BazeliskPython 3建议 3.7并预装 six 包可选项OpenCV桌面示例需要Linux 上推荐 3.x 至 4.1Android SDK/NDK仅在开发 Android 示例时才需要️ 安装主线本部分按拿代码、编译、验证顺序完成全部安装动作每一步都有明确完成标志。源码获取git clone https://gitcode.com/GitHub_Trending/med/mediapipe cd mediapipe仓库由三块组成框架核心mediapipe/framework/、示例应用mediapipe/examples/、计算图配置mediapipe/graphs/。后续命令都在仓库根目录执行ls能看到third_party/、WORKSPACE等内容即获取成功。编译构建与参数说明bazel build -c opt --define MEDIAPIPE_DISABLE_GPU1 mediapipe/examples/desktop/hello_world关键参数逐个解释-c opt以发布级优化编译产出的可执行文件运行更快--define MEDIAPIPE_DISABLE_GPU1关闭 GPU 依赖绕开 OpenGL/EGL 环境问题是首次搭建的最稳妥选择mediapipe/examples/desktop/hello_world要构建的示例目标首次构建会下载并编译全部依赖耗时取决于网络耐心等待即可。日志出现BUILD: Completed、可执行文件生成在bazel-bin/下即编译完成。跑通验证GLOG_logtostderr1 ./bazel-bin/mediapipe/examples/desktop/hello_world/hello_world示例内部跑了一个双节点 PassThroughCalculator 图并把字符串推入输出流。终端打印两次Hello World!就是可观察的成功标志说明 MediaPipe 环境已经就绪。⚠️ 出错怎么办下面四个高频故障按现象 → 原因 → 解法给出直接对照报错信息处理。现象ERROR: An error occurred during the fetch of repository local_execution_config_python原因Bazel 找不到本地 Python 解释器。解法在 bazel 命令追加--action_env PYTHON_BIN_PATHpython路径Windows 路径要用双斜杠例如C://python//python.exe。现象构建日志提示缺少 six 等 Python 依赖包原因构建脚本运行时依赖的 Python 包不在环境里。解法先执行pip3 install six再重新编译。现象编译报 OpenGL/EGL 头文件缺失原因开启了 GPU 模式而桌面缺少 EGL 开发库。解法首次搭建务必带上--define MEDIAPIPE_DISABLE_GPU1走 CPU 路径确需 GPU 时先按 docs/getting_started/gpu_support.md 装好 EGL 开发库。现象运行时报No registered calculator found原因用到的 calculator 没有被链接进可执行文件。解法确认构建的是完整示例目标自定义目标时检查所有依赖 calculator 是否都进入链接列表详见 docs/getting_started/troubleshooting.md。 装完之后验证通过就可以动手玩内置示例了入口如下mediapipe/examples/desktop/人脸检测、手部跟踪、姿态估计等 16 个命令行示例Linux/macOS 直接可跑mediapipe/examples/android/、mediapipe/examples/ios/移动端示例工程docs/framework_concepts/framework_concepts.mdcalculator、图、packet 等框架核心概念改图之前建议先读docs/getting_started/cpp.mdC 示例的 CPU/GPU 编译与运行细则下一步就三件事把构建目标换成examples/desktop/hand_tracking之一并编译、对着摄像头实际运行、遇到新报错回上面故障对照表核对。跑通一个完整示例后搭建阶段就算结束。【免费下载链接】mediapipeCross-platform, customizable ML solutions for live and streaming media.项目地址: https://gitcode.com/GitHub_Trending/med/mediapipe创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考