Hướng dẫn thiết lập Python

Trang này cho bạn biết cách thiết lập môi trường phát triển để sử dụng MediaPipe Tasks trong các ứng dụng Python.

Nền tảng và phiên bản được hỗ trợ

Việc xây dựng ứng dụng bằng MediaPipe Tasks cần có các tài nguyên môi trường phát triển sau đây:

  • Hệ điều hành:
    • Máy tính: Windows, Mac, Linux
    • IoT: Hệ điều hành mâm xôi 64 bit
  • Python: phiên bản 3.8 – 3.11
  • PIP: phiên bản 20.3 trở lên

Thiết lập môi trường dành cho nhà phát triển

Trước khi chạy một tác vụ MediaPipe trên ứng dụng Python, hãy cài đặt gói MediaPipe.

$ python -m pip install mediapipe

Sau khi cài đặt gói, hãy nhập gói đó vào dự án phát triển của bạn.

import mediapipe as mp

Các phần phụ thuộc MediaPipe Tasks

MediaPipe Tasks cung cấp 3 thư viện tạo sẵn dành cho thị giác, văn bản và âm thanh. Tuỳ thuộc vào Tác vụ MediaPipe mà ứng dụng sử dụng, hãy nhập thư viện tầm nhìn, văn bản hoặc âm thanh vào dự án phát triển của bạn.

Nhiệm vụ liên quan đến thị giác

Mô-đun thị giác của MediaPipe Tasks chứa các nhiệm vụ xử lý đầu vào là hình ảnh hoặc video. Để nhập thư viện thị giác MediaPipe Tasks, hãy nhập phần phụ thuộc sau đây vào dự án phát triển của bạn.

from mediapipe.tasks.python import vision

Việc cần làm liên quan đến văn bản

Mô-đun văn bản MediaPipe Tasks chứa các tác vụ xử lý thông tin đầu vào dạng chuỗi.Để nhập thư viện văn bản MediaPipe Tasks, hãy nhập phần phụ thuộc sau vào dự án phát triển của bạn.

from mediapipe.tasks.python import text

Việc cần làm về âm thanh

Mô-đun âm thanh MediaPipe Tasks chứa các tác vụ xử lý đầu vào âm thanh. Để nhập thư viện âm thanh MediaPipe Tasks, hãy nhập phần phụ thuộc sau vào dự án phát triển của bạn.

from mediapipe.tasks.python import audio

Cấu hình BaseOptions

BaseOptions cho phép cấu hình chung của MediaPipe Task API.

Tên tùy chọn Nội dung mô tả Giá trị được chấp nhận
model_asset_buffer Nội dung tệp thành phần mô hình. Mô hình nội dung dưới dạng một chuỗi byte
model_asset_path Đường dẫn của thành phần mô hình để mở và ánh xạ vào bộ nhớ. Đường dẫn tệp ở dạng chuỗi

Khắc phục sự cố

Để được trợ giúp về các câu hỏi kỹ thuật liên quan đến MediaPipe, hãy truy cập vào nhóm thảo luận hoặc Stack Overflow để được cộng đồng hỗ trợ. Để báo cáo lỗi hoặc đưa ra yêu cầu về tính năng, hãy gửi vấn đề trên GitHub.

Để được trợ giúp thiết lập môi trường phát triển Python, hãy truy cập vào Hướng dẫn dành cho nhà phát triển Python.