Python 設定指南

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

支援的平台和版本

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

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

開發人員環境設定

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

$ python -m pip install mediapipe

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

import mediapipe as mp

MediaPipe 工作依附元件

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

視覺工作

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

from mediapipe.tasks.python import vision

文字工作

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

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 開發人員指南