Cài đặt trên Debian và Ubuntu
Cài đặt Bazelisk.
Làm theo tài liệu chính thức về Bazelisk để cài đặt Bazelisk.
Kiểm tra kho lưu trữ MediaPipe.
$ cd $HOME $ git clone --depth 1 https://github.com/google/mediapipe.git # Change directory into MediaPipe root directory $ cd mediapipe
Cài đặt OpenCV và FFmpeg.
Lựa chọn 1. Sử dụng công cụ trình quản lý gói để cài đặt thư viện OpenCV được biên dịch trước. FFmpeg sẽ được cài đặt qua
libopencv-video-dev
.Hệ điều hành OpenCV Debian 9 (kéo dài) 2.4 Debian 10 (dịch vụ chặn) 3.2 Debian 11 (mắt bò) 4,5 Ubuntu 16.04 LTS 2.4 Ubuntu 18.04 LTS 3.2 Ubuntu 20.04 LTS 4,2 Ubuntu 20.04 LTS 4,2 Ubuntu 21.04 4,5 $ sudo apt-get install -y \ libopencv-core-dev \ libopencv-highgui-dev \ libopencv-calib3d-dev \ libopencv-features2d-dev \ libopencv-imgproc-dev \ libopencv-video-dev
Lưu ý. Trên Debian 11/Ubuntu 21.04 khi cài đặt OpenCV 4.5 với
libopencv-video-dev
, bạn cũng nên cài đặtlibopencv-contrib-dev
.$ sudo apt-get install -y libopencv-contrib-dev
opencv_linux.BUILD
vàWORKSPACE
của MediaPipe đã được định cấu hình cho OpenCV 2/3 và sẽ hoạt động chính xác trên mọi cấu trúc:# WORKSPACE new_local_repository( name = "linux_opencv", build_file = "@//third_party:opencv_linux.BUILD", path = "/usr", ) # opencv_linux.BUILD for OpenCV 2/3 installed from Debian package cc_library( name = "opencv", linkopts = [ "-l:libopencv_core.so", "-l:libopencv_calib3d.so", "-l:libopencv_features2d.so", "-l:libopencv_highgui.so", "-l:libopencv_imgcodecs.so", "-l:libopencv_imgproc.so", "-l:libopencv_video.so", "-l:libopencv_videoio.so", ], )
Đối với OpenCV 4, bạn cần sửa đổi
opencv_linux.BUILD
có tính đến cấu trúc hiện tại:# WORKSPACE new_local_repository( name = "linux_opencv", build_file = "@//third_party:opencv_linux.BUILD", path = "/usr", ) # opencv_linux.BUILD for OpenCV 4 installed from Debian package cc_library( name = "opencv", hdrs = glob([ # Uncomment according to your multiarch value (gcc -print-multiarch): # "include/aarch64-linux-gnu/opencv4/opencv2/cvconfig.h", # "include/arm-linux-gnueabihf/opencv4/opencv2/cvconfig.h", # "include/x86_64-linux-gnu/opencv4/opencv2/cvconfig.h", "include/opencv4/opencv2/**/*.h*", ]), includes = [ # Uncomment according to your multiarch value (gcc -print-multiarch): # "include/aarch64-linux-gnu/opencv4/", # "include/arm-linux-gnueabihf/opencv4/", # "include/x86_64-linux-gnu/opencv4/", "include/opencv4/", ], linkopts = [ "-l:libopencv_core.so", "-l:libopencv_calib3d.so", "-l:libopencv_features2d.so", "-l:libopencv_highgui.so", "-l:libopencv_imgcodecs.so", "-l:libopencv_imgproc.so", "-l:libopencv_video.so", "-l:libopencv_videoio.so", ], )
Lựa chọn 2. Chạy
setup_opencv.sh
để tự động tạo OpenCV từ nguồn và sửa đổi cấu hình OpenCV của MediaPipe. Tuỳ chọn này sẽ tự động thực hiện tất cả các bước được xác định trong Tuỳ chọn 3.Lựa chọn 3. Làm theo tài liệu của OpenCV để tạo OpenCV theo cách thủ công từ mã nguồn.
Bạn có thể cần phải sửa đổi
WORKSPACE
vàopencv_linux.BUILD
để trỏ MediaPipe đến thư viện OpenCV của riêng mình. Giả sử OpenCV sẽ được cài đặt vào/usr/local/
(nên dùng theo mặc định).Thiết lập OpenCV 2/3:
# WORKSPACE new_local_repository( name = "linux_opencv", build_file = "@//third_party:opencv_linux.BUILD", path = "/usr/local", ) # opencv_linux.BUILD for OpenCV 2/3 installed to /usr/local cc_library( name = "opencv", linkopts = [ "-L/usr/local/lib", "-l:libopencv_core.so", "-l:libopencv_calib3d.so", "-l:libopencv_features2d.so", "-l:libopencv_highgui.so", "-l:libopencv_imgcodecs.so", "-l:libopencv_imgproc.so", "-l:libopencv_video.so", "-l:libopencv_videoio.so", ], )
Thiết lập OpenCV 4:
# WORKSPACE new_local_repository( name = "linux_opencv", build_file = "@//third_party:opencv_linux.BUILD", path = "/usr/local", ) # opencv_linux.BUILD for OpenCV 4 installed to /usr/local cc_library( name = "opencv", hdrs = glob([ "include/opencv4/opencv2/**/*.h*", ]), includes = [ "include/opencv4/", ], linkopts = [ "-L/usr/local/lib", "-l:libopencv_core.so", "-l:libopencv_calib3d.so", "-l:libopencv_features2d.so", "-l:libopencv_highgui.so", "-l:libopencv_imgcodecs.so", "-l:libopencv_imgproc.so", "-l:libopencv_video.so", "-l:libopencv_videoio.so", ], )
Cách thiết lập FFmpeg hiện tại được xác định trong
ffmpeg_linux.BUILD
và sẽ phù hợp với mọi cấu trúc:# WORKSPACE new_local_repository( name = "linux_ffmpeg", build_file = "@//third_party:ffmpeg_linux.BUILD", path = "/usr" ) # ffmpeg_linux.BUILD for FFmpeg installed from Debian package cc_library( name = "libffmpeg", linkopts = [ "-l:libavcodec.so", "-l:libavformat.so", "-l:libavutil.so", ], )
Để chạy các ví dụ về máy tính chỉ trên Linux (không phải trên OS X) có tính năng tăng tốc GPU.
# Requires a GPU with EGL driver support. # Can use mesa GPU libraries for desktop, (or Nvidia/AMD equivalent). sudo apt-get install mesa-common-dev libegl1-mesa-dev libgles2-mesa-dev # To compile with GPU support, replace --define MEDIAPIPE_DISABLE_GPU=1 # with --copt -DMESA_EGL_NO_X11_HEADERS --copt -DEGL_NO_X11 # when building GPU examples.
Chạy ví dụ Hello World! trong C++.
$ export GLOG_logtostderr=1 # if you are running on Linux desktop with CPU only $ bazel run --define MEDIAPIPE_DISABLE_GPU=1 \ mediapipe/examples/desktop/hello_world:hello_world # If you are running on Linux desktop with GPU support enabled (via mesa drivers) $ bazel run --copt -DMESA_EGL_NO_X11_HEADERS --copt -DEGL_NO_X11 \ mediapipe/examples/desktop/hello_world:hello_world # Should print: # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World!
Nếu bạn gặp lỗi bản dựng, vui lòng đọc phần Khắc phục sự cố để tìm giải pháp cho một số vấn đề thường gặp về bản dựng.
Cài đặt trên CentOS
Tuyên bố từ chối trách nhiệm: Việc chạy MediaPipe trên CentOS đang trong giai đoạn thử nghiệm.
Cài đặt Bazelisk.
Làm theo tài liệu chính thức về Bazelisk để cài đặt Bazelisk.
Kiểm tra kho lưu trữ MediaPipe.
$ git clone --depth 1 https://github.com/google/mediapipe.git # Change directory into MediaPipe root directory $ cd mediapipe
Cài đặt OpenCV.
Tùy chọn 1. Sử dụng công cụ trình quản lý gói để cài đặt phiên bản được biên dịch trước.
$ sudo yum install opencv-devel
Tùy chọn 2. Tạo OpenCV từ mã nguồn.
new_local_repository( name = "linux_opencv", build_file = "@//third_party:opencv_linux.BUILD", path = "/usr/local", ) new_local_repository( name = "linux_ffmpeg", build_file = "@//third_party:ffmpeg_linux.BUILD", path = "/usr/local", ) cc_library( name = "opencv", srcs = glob( [ "lib/libopencv_core.so", "lib/libopencv_highgui.so", "lib/libopencv_imgcodecs.so", "lib/libopencv_imgproc.so", "lib/libopencv_video.so", "lib/libopencv_videoio.so", ], ), hdrs = glob([ # For OpenCV 3.x "include/opencv2/**/*.h*", # For OpenCV 4.x # "include/opencv4/opencv2/**/*.h*", ]), includes = [ # For OpenCV 3.x "include/", # For OpenCV 4.x # "include/opencv4/", ], linkstatic = 1, visibility = ["//visibility:public"], ) cc_library( name = "libffmpeg", srcs = glob( [ "lib/libav*.so", ], ), hdrs = glob(["include/libav*/*.h"]), includes = ["include"], linkopts = [ "-lavcodec", "-lavformat", "-lavutil", ], linkstatic = 1, visibility = ["//visibility:public"], )
Chạy ví dụ Hello World! trong C++.
$ export GLOG_logtostderr=1 # Need bazel flag 'MEDIAPIPE_DISABLE_GPU=1' if you are running on Linux desktop with CPU only $ bazel run --define MEDIAPIPE_DISABLE_GPU=1 \ mediapipe/examples/desktop/hello_world:hello_world # Should print: # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World!
Nếu bạn gặp lỗi bản dựng, vui lòng đọc phần Khắc phục sự cố để tìm giải pháp cho một số vấn đề thường gặp về bản dựng.
Cài đặt trên macOS
Chuẩn bị:
Cài đặt Bazelisk.
Làm theo tài liệu chính thức về Bazelisk để cài đặt Bazelisk.
Kiểm tra kho lưu trữ MediaPipe.
$ git clone --depth 1 https://github.com/google/mediapipe.git $ cd mediapipe
Cài đặt OpenCV và FFmpeg.
Tùy chọn 1. Sử dụng công cụ trình quản lý gói HomeBrew để cài đặt các thư viện OpenGL được biên dịch trước. FFmpeg sẽ được cài đặt qua OpenCV.
$ brew install opencv@3 # There is a known issue caused by the glog dependency. Uninstall glog. $ brew uninstall --ignore-dependencies glog
Tùy chọn 2. Sử dụng công cụ trình quản lý gói MacPorts để cài đặt các thư viện OpenCV.
$ port install opencv
new_local_repository( name = "macos_opencv", build_file = "@//third_party:opencv_macos.BUILD", path = "/opt", ) new_local_repository( name = "macos_ffmpeg", build_file = "@//third_party:ffmpeg_macos.BUILD", path = "/opt", ) cc_library( name = "opencv", srcs = glob( [ "local/lib/libopencv_core.dylib", "local/lib/libopencv_highgui.dylib", "local/lib/libopencv_imgcodecs.dylib", "local/lib/libopencv_imgproc.dylib", "local/lib/libopencv_video.dylib", "local/lib/libopencv_videoio.dylib", ], ), hdrs = glob(["local/include/opencv2/**/*.h*"]), includes = ["local/include/"], linkstatic = 1, visibility = ["//visibility:public"], ) cc_library( name = "libffmpeg", srcs = glob( [ "local/lib/libav*.dylib", ], ), hdrs = glob(["local/include/libav*/*.h"]), includes = ["local/include/"], linkopts = [ "-lavcodec", "-lavformat", "-lavutil", ], linkstatic = 1, visibility = ["//visibility:public"], )
Hãy đảm bảo bạn đã cài đặt Python 3 và thư viện "six" của Python.
$ brew install python $ sudo ln -s -f /usr/local/bin/python3.7 /usr/local/bin/python $ python --version Python 3.7.4 $ pip3 install --user six
Chạy ví dụ Hello World! trong C++.
$ export GLOG_logtostderr=1 # Need bazel flag 'MEDIAPIPE_DISABLE_GPU=1' as desktop GPU is currently not supported $ bazel run --define MEDIAPIPE_DISABLE_GPU=1 \ mediapipe/examples/desktop/hello_world:hello_world # Should print: # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World!
Nếu bạn gặp lỗi bản dựng, vui lòng đọc phần Khắc phục sự cố để tìm giải pháp cho một số vấn đề thường gặp về bản dựng.
Cài đặt trên Windows
Tuyên bố từ chối trách nhiệm: Chạy MediaPipe trên Windows đang trong giai đoạn thử nghiệm.
Cài đặt MSYS2 rồi chỉnh sửa biến môi trường
%PATH%
.Nếu MSYS2 được cài đặt vào
C:\msys64
, hãy thêmC:\msys64\usr\bin
vào biến môi trường%PATH%
.Cài đặt các gói cần thiết.
C:\> pacman -S git patch unzip
Cài đặt Python và cho phép tệp thực thi chỉnh sửa biến môi trường
%PATH%
.Tải tệp thực thi Windows bằng Python xuống từ https://www.python.org/downloads rồi cài đặt.
Cài đặt Công cụ xây dựng Visual C++ 2019 và WinSDK
Truy cập trang web VisualStudio, tải công cụ bản dựng xuống và cài đặt Microsoft Visual C++ 2019 Re Adutable và Microsoft Build Tools 2019.
Tải WinSDK xuống từ trang web chính thức của MicroSoft rồi cài đặt.
Cài đặt Bazel hoặc Bazelisk và thêm vị trí của tệp thực thi Bazel vào biến môi trường
%PATH%
.Tùy chọn 1. Làm theo tài liệu chính thức của Bazel để cài đặt Bazel 6.1.1 trở lên.
Tùy chọn 2. Làm theo tài liệu chính thức về Bazelisk để cài đặt Bazelisk.
Đặt biến Bazel. Tìm hiểu thêm thông tin chi tiết về "Tạo trên Windows" trong tài liệu chính thức của Bazel.
# Please find the exact paths and version numbers from your local version. C:\> set BAZEL_VS=C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools C:\> set BAZEL_VC=C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC C:\> set BAZEL_VC_FULL_VERSION=<Your local VC version> C:\> set BAZEL_WINSDK_FULL_VERSION=<Your local WinSDK version>
Kiểm tra kho lưu trữ MediaPipe.
C:\Users\Username\mediapipe_repo> git clone --depth 1 https://github.com/google/mediapipe.git # Change directory into MediaPipe root directory C:\Users\Username\mediapipe_repo> cd mediapipe
Cài đặt OpenCV.
Tải tệp thực thi Windows xuống từ https://opencv.org/releases/ rồi cài đặt. MediaPipe 0.10.x hỗ trợ OpenCV 3.4.10. Hãy nhớ chỉnh sửa tệp
WORKSPACE
nếu OpenCV chưa được cài đặt tạiC:\opencv
.new_local_repository( name = "windows_opencv", build_file = "@//third_party:opencv_windows.BUILD", path = "C:\\<path to opencv>\\build", )
Chạy ví dụ Hello World! trong C++.
C:\Users\Username\mediapipe_repo>bazel build -c opt --define MEDIAPIPE_DISABLE_GPU=1 --action_env PYTHON_BIN_PATH="C://python_36//python.exe" mediapipe/examples/desktop/hello_world C:\Users\Username\mediapipe_repo>set GLOG_logtostderr=1 C:\Users\Username\mediapipe_repo>bazel-bin\mediapipe\examples\desktop\hello_world\hello_world.exe # should print: # I20200514 20:43:12.277598 1200 hello_world.cc:56] Hello World! # I20200514 20:43:12.278597 1200 hello_world.cc:56] Hello World! # I20200514 20:43:12.279618 1200 hello_world.cc:56] Hello World! # I20200514 20:43:12.279618 1200 hello_world.cc:56] Hello World! # I20200514 20:43:12.279618 1200 hello_world.cc:56] Hello World! # I20200514 20:43:12.279618 1200 hello_world.cc:56] Hello World! # I20200514 20:43:12.279618 1200 hello_world.cc:56] Hello World! # I20200514 20:43:12.279618 1200 hello_world.cc:56] Hello World! # I20200514 20:43:12.279618 1200 hello_world.cc:56] Hello World! # I20200514 20:43:12.280613 1200 hello_world.cc:56] Hello World!
Nếu bạn gặp lỗi bản dựng, vui lòng đọc phần Khắc phục sự cố để tìm giải pháp cho một số vấn đề thường gặp về bản dựng.
Cài đặt trên Hệ thống con Windows dành cho Linux (WSL)
Làm theo hướng dẫn để cài đặt Hệ thống con Windows dành cho Linux (Ubuntu).
Cài đặt Windows ADB và khởi động máy chủ ADB trong Windows.
Chạy WSL.
Cài đặt các gói cần thiết.
username@DESKTOP-TMVLBJ1:~$ sudo apt-get update && sudo apt-get install -y build-essential git python zip adb openjdk-8-jdk
Cài đặt Bazelisk.
Làm theo tài liệu chính thức về Bazelisk để cài đặt Bazelisk.
Kiểm tra kho lưu trữ MediaPipe.
username@DESKTOP-TMVLBJ1:~$ git clone --depth 1 https://github.com/google/mediapipe.git username@DESKTOP-TMVLBJ1:~$ cd mediapipe
Cài đặt OpenCV và FFmpeg.
Tùy chọn 1. Sử dụng công cụ trình quản lý gói để cài đặt thư viện OpenCV được biên dịch trước. FFmpeg sẽ được cài đặt qua libopencv-video-dev.
username@DESKTOP-TMVLBJ1:~/mediapipe$ sudo apt-get install libopencv-core-dev libopencv-highgui-dev \ libopencv-calib3d-dev libopencv-features2d-dev \ libopencv-imgproc-dev libopencv-video-dev
Tùy chọn 2. Chạy
setup_opencv.sh
để tự động tạo OpenCV từ nguồn và sửa đổi cấu hình OpenCV của MediaPipe.Lựa chọn 3. Làm theo tài liệu của OpenCV để tạo OpenCV theo cách thủ công từ mã nguồn.
WORKSPACE
WORKSPACE
WORKSPACE
WORKSPACE
opencv_linux.BUILD
new_local_repository( name = "linux_opencv", build_file = "@//third_party:opencv_linux.BUILD", path = "/usr/local", ) cc_library( name = "opencv", srcs = glob( [ "lib/libopencv_core.so", "lib/libopencv_highgui.so", "lib/libopencv_imgcodecs.so", "lib/libopencv_imgproc.so", "lib/libopencv_video.so", "lib/libopencv_videoio.so", ], ), hdrs = glob(["include/opencv4/**/*.h*"]), includes = ["include/opencv4/"], linkstatic = 1, visibility = ["//visibility:public"], )
Chạy ví dụ Hello World! trong C++.
username@DESKTOP-TMVLBJ1:~/mediapipe$ export GLOG_logtostderr=1 # Need bazel flag 'MEDIAPIPE_DISABLE_GPU=1' as desktop GPU is currently not supported username@DESKTOP-TMVLBJ1:~/mediapipe$ bazel run --define MEDIAPIPE_DISABLE_GPU=1 \ mediapipe/examples/desktop/hello_world:hello_world # Should print: # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World!
Nếu bạn gặp lỗi bản dựng, vui lòng đọc bài viết Khắc phục sự cố để tìm giải pháp cho một số vấn đề thường gặp về bản dựng.
Cài đặt bằng Docker
Thao tác này sẽ sử dụng hình ảnh Docker để tách biệt việc cài đặt của mediapipe với phần còn lại của hệ thống.
Cài đặt Docker trên hệ thống lưu trữ của bạn.
Tạo hình ảnh Docker bằng thẻ "mediapipe".
$ git clone --depth 1 https://github.com/google/mediapipe.git $ cd mediapipe $ docker build --tag=mediapipe . # Should print: # Sending build context to Docker daemon 147.8MB # Step 1/9 : FROM ubuntu:latest # latest: Pulling from library/ubuntu # 6abc03819f3e: Pull complete # 05731e63f211: Pull complete # ........ # See http://bazel.build/docs/getting-started.html to start a new project! # Removing intermediate container 82901b5e79fa # ---> f5d5f402071b # Step 9/9 : COPY . /edge/mediapipe/ # ---> a95c212089c5 # Successfully built a95c212089c5 # Successfully tagged mediapipe:latest
Chạy ví dụ Hello World! trong C++.
$ docker run -it --name mediapipe mediapipe:latest root@bca08b91ff63:/mediapipe# GLOG_logtostderr=1 bazel run --define MEDIAPIPE_DISABLE_GPU=1 mediapipe/examples/desktop/hello_world # Should print: # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World! # Hello World!
Nếu bạn gặp lỗi bản dựng, vui lòng đọc bài viết Khắc phục sự cố để tìm giải pháp cho một số vấn đề thường gặp về bản dựng.
Tạo một ví dụ về Android MediaPipe.
$ docker run -it --name mediapipe mediapipe:latest root@bca08b91ff63:/mediapipe# bash ./setup_android_sdk_and_ndk.sh # Should print: # Android NDK is now installed. Consider setting $ANDROID_NDK_HOME environment variable to be /root/Android/Sdk/ndk-bundle/android-ndk-r19c # Set android_ndk_repository and android_sdk_repository in WORKSPACE # Done root@bca08b91ff63:/mediapipe# bazel build -c opt --config=android_arm64 mediapipe/examples/android/src/java/com/google/mediapipe/apps/objectdetectiongpu:objectdetectiongpu # Should print: # Target //mediapipe/examples/android/src/java/com/google/mediapipe/apps/objectdetectiongpu:objectdetectiongpu up-to-date: # bazel-bin/mediapipe/examples/android/src/java/com/google/mediapipe/apps/objectdetectiongpu/objectdetectiongpu_deploy.jar # bazel-bin/mediapipe/examples/android/src/java/com/google/mediapipe/apps/objectdetectiongpu/objectdetectiongpu_unsigned.apk # bazel-bin/mediapipe/examples/android/src/java/com/google/mediapipe/apps/objectdetectiongpu/objectdetectiongpu.apk # INFO: Elapsed time: 144.462s, Critical Path: 79.47s # INFO: 1958 processes: 1 local, 1863 processwrapper-sandbox, 94 worker. # INFO: Build completed successfully, 2028 total actions