Udhëzues konfigurimi për Python

Kjo faqe ju tregon se si të konfiguroni mjedisin tuaj të zhvillimit për të përdorur MediaPipe Tasks në aplikacionet tuaja Python.

Platformat dhe versionet e mbështetura

Ndërtimi i aplikacioneve me MediaPipe Tasks kërkon burimet e mëposhtme të mjedisit të zhvillimit:

• Sistemi operativ:
  • Desktop: Windows, Mac, Linux
  • IoT: Raspberry OS 64-bit
• Python: versioni 3.9 - 3.12
• PIP: versioni 20.3+

Konfigurimi i mjedisit të zhvilluesit

Para se të ekzekutoni një detyrë MediaPipe në një aplikacion Python, instaloni paketën MediaPipe.

$ python -m pip install mediapipe

Pas instalimit të paketës, importojeni atë në projektin tuaj të zhvillimit.

import mediapipe as mp

Varësitë e Detyrave të MediaPipe

MediaPipe Tasks ofron tre biblioteka të parapërgatitura për vizion, tekst dhe audio. Në varësi të MediaPipe Task që përdoret nga aplikacioni, importoni bibliotekën e vizionit, tekstit ose audios në projektin tuaj të zhvillimit.

Detyrat e vizionit

Moduli i vizionit MediaPipe Tasks përmban detyra që trajtojnë hyrjet e imazheve ose videove. Për të importuar bibliotekën e vizionit MediaPipe Tasks, importoni varësinë e mëposhtme në projektin tuaj të zhvillimit.

from mediapipe.tasks.python import vision

Detyrat me tekst

Moduli tekst i MediaPipe Tasks përmban detyra që trajtojnë hyrjet e vargjeve. Për të importuar bibliotekën e tekstit të MediaPipe Tasks, importoni varësinë e mëposhtme në projektin tuaj të zhvillimit.

from mediapipe.tasks.python import text

Detyrat audio

Moduli audio i MediaPipe Tasks përmban detyra që trajtojnë hyrjet e zërit. Për të importuar bibliotekën audio të MediaPipe Tasks, importoni varësinë e mëposhtme në projektin tuaj të zhvillimit.

from mediapipe.tasks.python import audio

Konfigurimi i BaseOptions

BaseOptions lejojnë konfigurimin e përgjithshëm të API-ve të Detyrave të MediaPipe.

Paketimi i aplikacioneve Python Tasks me PyInstaller

Kur paketoni një aplikacion Python Tasks me PyInstaller, skedarët e modelit si paketat .task nuk përfshihen automatikisht. Nëse aplikacioni juaj përdor BaseOptions(model_asset_path=...) , përfshijeni skedarin e modelit në paketën PyInstaller dhe zgjidhni rrugën e tij gjatë kohës së ekzekutimit.

Për shembull, përdorni një ndihmës që kontrollon për direktorinë sys._MEIPASS të PyInstaller:

import os
import sys

def resource_path(relative_path: str) -> str:
    base_path = getattr(sys, "_MEIPASS", os.path.abspath("."))
    return os.path.join(base_path, relative_path)

Pastaj kalojeni shtegun e modelit të zgjidhur te BaseOptions :

from mediapipe.tasks import python
from mediapipe.tasks.python import vision

model_path = resource_path("pose_landmarker.task")
base_options = python.BaseOptions(model_asset_path=model_path)
options = vision.PoseLandmarkerOptions(base_options=base_options)
pose_landmarker = vision.PoseLandmarker.create_from_options(options)

Bashkoni skedarin e modelit dhe mblidhni skedarët e paketës MediaPipe kur ndërtoni me PyInstaller:

pyinstaller app.py \
  --add-data "pose_landmarker.task:." \
  --collect-all mediapipe \
  --hidden-import mediapipe.tasks.c

Në macOS ose Linux, ndarësi --add-data është : . Në Windows, përdorni ; . Dhe për aplikacionet e desktopit macOS, shtoni --windowed për të krijuar një paketë .app :

Zgjidhja e problemeve

Për ndihmë me pyetje teknike që lidhen me MediaPipe, vizitoni grupin e diskutimit ose Stack Overflow për mbështetje nga komuniteti. Për të raportuar gabime ose për të bërë kërkesa për veçori, paraqitni një problem në GitHub .

Për ndihmë në konfigurimin e mjedisit tuaj të zhvillimit Python, vizitoni udhëzuesin e zhvilluesit të Python .