Bu sayfada, Python uygulamalarınızda MediaPipe Görevleri'ni kullanmak için geliştirme ortamınızı nasıl ayarlayacağınız gösterilmektedir.
Desteklenen platformlar ve sürümler
MediaPipe Görevleri ile uygulama oluşturmak için aşağıdaki geliştirme ortamı kaynakları gerekir:
- İşletim sistemi:
- Masaüstü: Windows, Mac, Linux
- IoT: Raspberry OS 64 bit
- Python: 3.9 - 3.12 sürümleri
- PIP: 20.3 veya sonraki sürümler
Geliştirme ortamı kurulumu
Python uygulamasında MediaPipe görevini çalıştırmadan önce MediaPipe paketini yükleyin.
$ python -m pip install mediapipe
Paketi yükledikten sonra geliştirme projenize aktarın.
import mediapipe as mp
MediaPipe Görevleri bağımlılıkları
MediaPipe Görevleri, görme, metin ve ses için önceden oluşturulmuş üç kitaplık sağlar. Uygulama tarafından kullanılan MediaPipe Görevine bağlı olarak, vision, text veya audio kitaplığını geliştirme projenize aktarın.
Vision görevleri
MediaPipe Görevleri Vision modülü, resim veya video girişlerini işleyen görevleri içerir. MediaPipe Görevleri Vision kitaplığını içe aktarmak için aşağıdaki bağımlılığı geliştirme projenize aktarın.
from mediapipe.tasks.python import vision
Metin görevleri
MediaPipe Görevleri metin modülü, dize girişlerini işleyen görevleri içerir.MediaPipe Görevleri metin kitaplığını içe aktarmak için aşağıdaki bağımlılığı geliştirme projenize aktarın.
from mediapipe.tasks.python import text
Ses görevleri
MediaPipe Görevleri ses modülü, ses girişlerini işleyen görevleri içerir. MediaPipe Görevleri ses kitaplığını içe aktarmak için aşağıdaki bağımlılığı geliştirme projenize aktarın.
from mediapipe.tasks.python import audio
BaseOptions yapılandırması
BaseOptions, MediaPipe Task API'lerinin genel yapılandırmasına olanak tanır.
| Seçenek adı | Açıklama | Kabul edilen değerler |
|---|---|---|
model_asset_buffer |
Model öğesi dosyasının içeriği. | Model içeriğini bayt dizesi olarak kullanma |
model_asset_path |
Açılacak ve belleğe eşlenecek model öğesinin yolu. | Dize olarak dosya yolu |
PyInstaller ile Python Görevleri uygulamalarını paketleme
PyInstaller ile bir Python Tasks uygulaması paketlenirken .task paketleri gibi model dosyaları otomatik olarak dahil edilmez. Uygulamanız BaseOptions(model_asset_path=...) kullanıyorsa model dosyasını PyInstaller paketine ekleyin ve yolunu çalışma zamanında çözün.
Örneğin, PyInstaller'ın sys._MEIPASS
dizinini kontrol eden bir yardımcı kullanın:
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)
Ardından, çözümlenen model yolunu BaseOptions'a iletin:
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)
PyInstaller ile derleme yaparken model dosyasını paketleyin ve MediaPipe paket dosyalarını toplayın:
pyinstaller app.py \
--add-data "pose_landmarker.task:." \
--collect-all mediapipe \
--hidden-import mediapipe.tasks.c
macOS veya Linux'ta --add-data ayırıcı : olur. Windows'da ; kullanın. macOS masaüstü uygulamaları için --windowed ekleyerek .app paketi oluşturun:
Sorun giderme
MediaPipe ile ilgili teknik sorularınız için tartışma grubunu veya topluluktan destek almak için Stack Overflow'u ziyaret edin. Hata bildirmek veya özellik isteğinde bulunmak için GitHub'da sorun kaydı oluşturun.
Python geliştirme ortamınızı kurma konusunda yardım almak için Python geliştirici kılavuzunu ziyaret edin.