Android 设置指南

本页介绍了如何设置开发环境以使用 MediaPipe Android 应用中的 Tasks。

支持的设备和平台

要使用 MediaPipe Tasks 创建 Android 应用，您的开发 环境要求如下：

  • Android Studio 推荐版本至少为 2021.1.1 (Bumblebee)，或其他兼容的 IDE。
  • Android SDK 版本 24 或更高版本
  • 搭载最低 SDK 版本的 Android 设备。Android 模拟器 可能无法执行某些任务。

开发者环境设置

在 Android 应用上运行 MediaPipe 任务之前，您必须 现有应用，或在本地计算机上创建新的 Android Studio 项目。 MediaPipe 适合 应用层之后， 其中包含应用数据和业务逻辑。如需详细了解 Android 应用架构，请参阅应用指南 架构。

Android 设备设置

您必须在实体 Android 设备上启用开发者选项和 USB 调试 然后再使用它来测试您的应用如需了解如何配置 设备上有“开发者选项”，请参阅配置设备上的开发者 选项。

对于不需要设备摄像头或麦克风的任务，您可以使用 Android 设备模拟器，而不是实体 Android 设备。相关说明 有关如何设置 Android 模拟器的信息，请参阅在 Android 设备上运行应用 模拟器。

示例代码设置

MediaPipe 示例仓库 包含每个 MediaPipe 任务的 Android 应用示例。您可以创建一个 项目，构建项目，然后运行该项目。

如需导入并构建示例代码项目，请执行以下操作：

  1. 启动 Android Studio。
  2. 在 Android Studio 中，选择 File >新建 >导入项目。
  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 SUCCESSFUL Build Output 状态面板。

如需运行项目，请执行以下操作：

  1. 在 Android Studio 中，依次选择 Run >Run...。
  2. 选择连接的 Android 设备（或模拟器）以测试应用。

MediaPipe Tasks 依赖项

MediaPipe Tasks 提供了三个预构建的视觉、文本和音频库。通过 .tflite 模型文件必须位于 Android 的资源目录中 使用该模型。根据应用使用的 MediaPipe Task，添加 传递给视觉、文本或音频库的依赖项列表， build.gradle 文件。

<ph type="x-smartling-placeholder">

生成式 AI 任务

MediaPipe Tasks 生成式 AI 库包含用于处理图像或 生成文本。如需导入 MediaPipe Tasks 生成式 AI 库，请执行以下操作： 在 Android Studio 中，将依赖项添加到您的 build.gradle 文件中。

图片生成器

MediaPipe Image Generator 任务包含在 tasks-vision-image-generator 库。将依赖项添加到您的 build.gradle 文件：

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

LLM Inference API

MediaPipe LLM 推断任务包含在 tasks-genai 中 库。将依赖项添加到您的 build.gradle 文件中：

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

视觉任务

MediaPipe Tasks 视觉库包含处理图片或视频的任务 输入。如需在 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 设备上，您可以启用 使用委托 (delegate) 以 GPU 加速的方式执行模型。受托人身份 适用于 MediaPipe 的硬件驱动程序，让您可以在 GPU 上运行模型 而不是标准 CPU 处理器

通过 BaseOptions 在任务选项中配置 GPU 委托：

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

问题排查

如需有关 MediaPipe 的技术问题方面的帮助，请访问 群组或堆栈 用于寻求支持的其他人员 社区。要报告错误或提出功能请求，请在以下位置提交问题： GitHub。

如需有关设置 Android 开发环境的帮助，请访问 Android 开发者文档。