Android 設定指南

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

支援的裝置和平台

如要使用 MediaPipe Tasks 建立 Android 應用程式，您的開發環境必須具備下列項目：

• 具備建議版本至少為 2021.1.1 (Bumblebee) 的 Android Studio，或其他相容的 IDE。
• Android SDK 24 以上版本
• 至少具備 SDK 最低版本的 Android 裝置。Android 模擬器可能無法處理所有工作。

開發人員環境設定

在 Android 應用程式上執行 MediaPipe 工作之前，您必須擁有現有應用程式，或是在本機電腦上建立新的 Android Studio 專案。MediaPipe 適用於應用程式的資料層，其中包含應用程式資料和商業邏輯。如要進一步瞭解 Android 應用程式架構，請參閱「應用程式架構指南」。

Android 裝置設定

您必須先在實體 Android 裝置上啟用開發人員選項和 USB 偵錯功能，才能用來測試應用程式。如需透過開發人員選項設定裝置的操作說明，請參閱「設定裝置端開發人員選項」。

如果工作不需要裝置相機或麥克風，您可以使用 Android 裝置模擬器，不要使用實體 Android 裝置。如需設定 Android Emulator 的操作說明，請參閱「在 Android Emulator 上執行應用程式」。

程式碼範例設定

MediaPipe 範例存放區包含每個 MediaPipe 工作的 Android 應用程式範例。您可以透過程式碼範例建立專案，然後建構並執行專案。

如要匯入及建構程式碼範例專案：

1. 啟動 Android Studio。
2. 在 Android Studio 中，選取「File」(檔案) >「New」(新增) >「Import Project」(匯入專案)。
3. 前往包含 build.gradle 檔案的程式碼範例目錄，然後選取該目錄，例如：.../mediapipe/examples/text_classification/android/build.gradle
4. 如果 Android Studio 要求 Gradle 同步處理，請選擇「OK」。
5. 請確認 Android 裝置已連接至電腦，並且已啟用開發人員模式。按一下綠色的 Run 箭頭。

如果選取正確的目錄，Android Studio 會建立新專案並加以建構。視電腦速度以及您是否已將 Android Studio 用於其他專案而定，這項程序可能需要幾分鐘才能完成。建構完成後，Android Studio 會在「Build Output」狀態面板中顯示 BUILD SUCCESSFUL 訊息。

執行專案的步驟如下：

1. 在 Android Studio 中，依序選取「Run」>「Run...」來執行專案。
2. 選取已連結的 Android 裝置 (或模擬器) 來測試應用程式。

MediaPipe 工作依附元件

MediaPipe Tasks 提供三個預先建構的程式庫，適用於視覺、文字、音訊。.tflite 模型檔案必須位於使用模型的 Android 模組資產目錄中。視應用程式使用的 MediaPipe 工作，將視覺、文字或音樂庫新增至 build.gradle 檔案的依附元件清單。

生成式 AI 工作

MediaPipe Tasks Generative AI 程式庫包含處理圖片或文字生成的工作。如要在 Android Studio 中匯入 MediaPipe Tasks Generative AI 程式庫，請將依附元件新增至 build.gradle 檔案。

圖片產生器

MediaPipe 圖片產生器工作包含在 tasks-vision-image-generator 程式庫中。將依附元件新增至 build.gradle 檔案：

dependencies {
    implementation 'com.google.mediapipe:tasks-vision-image-generator:latest.release'
}

LLM 推論 API

MediaPipe LLM 推論工作包含在 tasks-genai 程式庫中。將依附元件新增至 build.gradle 檔案：

dependencies {
    implementation 'com.google.mediapipe:tasks-genai:latest.release'
}

視覺工作

MediaPipe 工作視覺程式庫包含處理圖片或影片輸入內容的工作。如要在 Android Studio 中匯入 MediaPipe Tasks 工作視覺程式庫，請在 build.gradle 檔案中加入以下依附元件：

dependencies {
    implementation 'com.google.mediapipe:tasks-vision:latest.release'
}

文字工作

MediaPipe Tasks 文字程式庫包含處理文字格式語言資料的工作。如要在 Android Studio 中匯入 MediaPipe Tasks 文字程式庫，請將下列依附元件新增至 build.gradle 檔案：

dependencies {
    implementation 'com.google.mediapipe:tasks-text:latest.release'
}

音訊工作

MediaPipe Tasks 音樂庫包含處理聲音輸入內容的工作。如要在 Android Studio 中匯入 MediaPipe Tasks 音樂庫，請在 build.gradle 檔案中新增以下依附元件：

dependencies {
    implementation 'com.google.mediapipe:tasks-audio:latest.release'
}

BaseOptions 設定

BaseOptions 允許對 MediaPipe Task API 的一般設定。

選項名稱	說明	接受的值
modelAssetBuffer	模型素材資源檔案內容，形式為直接 ByteBuffer 或 MappedByteBuffer。	ByteBuffer 或 MappedByteBuffer 字串
modelAssetPath	Android 應用程式素材資源資料夾中的模型素材資源檔案模型路徑。	字串形式的檔案路徑
modelAssetFileDescriptor	模型資產檔案的原生檔案描述元整數。	指定檔案描述元的整數
Delegate	透過裝置委派項目啟用硬體加速功能，以執行 MediaPipe 管道。預設值為 CPU。	[CPU, GPU]

硬體加速

MediaPipe Tasks 支援使用圖形處理器 (GPU) 執行機器學習模型。在 Android 裝置上，您可以使用委派項目啟用模型的 GPU 加速執行功能。委派代表是 MediaPipe 的硬體驅動程式，因此您可以在 GPU 處理器 (而非標準 CPU 處理器) 上執行模型。

透過 BaseOptions 在工作選項中設定 GPU 委派：

BaseOptions baseOptions = BaseOptions.builder().useGpu().build();

疑難排解

如需 MediaPipe 相關技術問題的協助，請造訪討論群組或 StackOverflow 取得社群支援。如要回報錯誤或提出功能要求，請在 GitHub 上回報問題。

如需設定 Android 開發環境的相關說明，請參閱 Android 開發人員說明文件。