Python 設定指南

本頁說明如何設定開發環境,以便在 Python 應用程式中使用 MediaPipe 工作。

支援的平台和版本

使用 MediaPipe Tasks 建構應用程式需要下列開發環境資源:

  • OS:
    • 電腦:Windows、Mac、Linux
    • IoT:Raspberry OS 64 位元
  • Python:3.9 - 3.12 版
  • PIP:20.3 版以上

開發人員環境設定

在 Python 應用程式上執行 MediaPipe 工作之前,請先安裝 MediaPipe 套件。

$ python -m pip install mediapipe

安裝套件後,請將其匯入開發專案。

import mediapipe as mp

MediaPipe 工作依附元件

MediaPipe Tasks 提供三個預建程式庫,適用於視覺、文字和音訊。根據應用程式使用的 MediaPipe 工作,將視覺、文字或音訊程式庫匯入您的開發專案。

視覺任務

MediaPipe Tasks 視覺模組包含處理圖片或影片輸入內容的工作,如要匯入 MediaPipe Tasks 視覺程式庫,請將下列依附元件匯入您的開發專案。

from mediapipe.tasks.python import vision

文字工作

MediaPipe Tasks 文字模組包含處理字串輸入內容的工作。如要匯入 MediaPipe 工作文字程式庫,請將下列依附元件匯入您的開發專案。

from mediapipe.tasks.python import text

音訊工作

MediaPipe Tasks 音訊模組包含處理聲音輸入的工作。如要匯入 MediaPipe Tasks 音樂庫,請將下列依附元件匯入您的開發專案。

from mediapipe.tasks.python import audio

BaseOptions 設定

BaseOptions 允許適用於 MediaPipe Task API 的一般設定。

選項名稱 說明 接受的值
model_asset_buffer 模型資產檔案內容。 以位元組字串形式建立模型內容
model_asset_path 要開啟並對應至記憶體的模型資產路徑。 字串形式的檔案路徑

疑難排解

如需 MediaPipe 相關技術問題的說明,請前往討論群組Stack Overflow,向社群尋求支援。如要回報錯誤或提出功能要求,請在 GitHub 上回報問題

如需設定 Python 開發環境的說明,請參閱 Python 開發人員指南