이 페이지에서는 MediaPipe를 사용하도록 개발 환경을 설정하는 방법을 설명합니다. Android 애플리케이션의 할 일 목록
지원되는 기기 및 플랫폼
MediaPipe Tasks로 Android 애플리케이션을 만들려면 개발용 환경 요구사항:
- Android 스튜디오 2021.1.1 (Bumblebee) 이상 권장 버전 또는 호환되는 다른 버전 지원합니다.
- Android SDK 버전 24 이상
- 최소 SDK 버전 이상의 Android 기기 Android Emulator 일부 태스크에는 작동하지 않을 수 있습니다.
개발자 환경 설정
Android 애플리케이션에서 MediaPipe 작업을 실행하려면 먼저 기존 앱을 만들거나 로컬 머신에서 새 Android 스튜디오 프로젝트를 만듭니다. MediaPipe는 데이터의 애플리케이션 데이터와 비즈니스 로직이 포함되어 있습니다 자세한 내용은 Android 앱 아키텍처는 앱 가이드 참고 아키텍처를 참고하세요.
Android 기기 설정
실제 Android 기기에서 개발자 옵션과 USB 디버깅을 사용 설정해야 합니다. 익스플로이트를 사용해 보시기 바랍니다. 구성 방법에 대한 지침은 자세히 알아보려면 온디바이스 개발자 구성 옵션을 참조하세요.
기기의 카메라나 마이크가 필요하지 않은 작업의 경우 실제 Android 기기 대신 Android 기기 에뮬레이터 안내 보기 Android Emulator 설정에 관한 자세한 내용은 Android Emulator에서 앱 실행 에뮬레이터.
예시 코드 설정
MediaPipe 예시 저장소 에는 각 MediaPipe 작업에 대한 Android 애플리케이션의 예가 포함됩니다. 다음과 같은 방법을 사용할 수 있습니다. 프로젝트를 빌드하고 실행합니다.
예시 코드 프로젝트를 가져와 빌드하는 방법은 다음과 같습니다.
- Android 스튜디오를 시작합니다.
- Android 스튜디오에서 File > 신규 > 프로젝트 가져오기를 클릭합니다.
build.gradle파일이 포함된 예시 코드 디렉터리로 이동 해당 디렉터리를 선택합니다. 예를 들면 다음과 같습니다..../mediapipe/examples/text_classification/android/build.gradle- Android 스튜디오에서 Gradle 동기화를 요청하면 OK를 선택합니다.
- Android 기기가 컴퓨터 및 개발자에 연결되어 있는지 확인하세요.
사용 설정됩니다. 녹색
Run화살표를 클릭합니다.
올바른 디렉터리를 선택하면 Android Studio가 새 프로젝트를 생성하고
구축합니다. 이 과정은 네트워크 속도에 따라 몇 분 정도 소요될 수 있습니다.
다른 프로젝트에서 Android 스튜디오를 사용한 적이 있는지 확인합니다. 빌드가 완료되면
완료되면 Android 스튜디오에서 BUILD SUCCESSFUL 메시지를
Build Output 상태 패널
프로젝트를 실행하려면 다음 안내를 따르세요.
- Android 스튜디오에서 Run > Run...을 선택합니다.
- 연결된 Android 기기 (또는 에뮬레이터)를 선택하여 앱을 테스트합니다.
MediaPipe 태스크 종속 항목
MediaPipe Tasks는 비전, 텍스트, 오디오를 위해 사전 빌드된 세 가지 라이브러리를 제공합니다. 이
.tflite 모델 파일은 Android의 assets 디렉터리에 있어야 합니다.
모듈을 마칩니다 앱에서 사용하는 MediaPipe 작업에 따라
비전, 텍스트 또는 오디오 라이브러리를
build.gradle 파일.
생성형 AI 작업
MediaPipe Tasks 생성형 AI 라이브러리에는 이미지 또는
있습니다. MediaPipe Tasks 생성형 AI 라이브러리를 가져오려면
Android 스튜디오에서 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 Tasks 비전 라이브러리에는 이미지 또는 동영상을 처리하는 작업이 포함되어 있습니다.
인코더-디코더입니다 Android 스튜디오에서 MediaPipe Tasks 비전 라이브러리를 가져오려면 다음을 추가합니다.
build.gradle 파일에 다음 종속 항목을 추가합니다.
dependencies {
implementation 'com.google.mediapipe:tasks-vision:latest.release'
}
텍스트 작업
MediaPipe Tasks 텍스트 라이브러리에는
있습니다. Android 스튜디오에서 MediaPipe Tasks 텍스트 라이브러리를 가져오려면 다음을 추가합니다.
build.gradle 파일에 다음 종속 항목을 추가합니다.
dependencies {
implementation 'com.google.mediapipe:tasks-text:latest.release'
}
오디오 작업
MediaPipe Tasks 오디오 라이브러리에는 사운드 입력을 처리하는 작업이 포함되어 있습니다. 받는사람
Android 스튜디오에서 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 태스크는 그래픽 처리 장치 (GPU)를 사용하여 실행할 수 있도록 지원합니다. 머신러닝 모델입니다. Android 기기에서 대리자를 사용하여 모델의 GPU 가속 실행 위임받은 역할 MediaPipe용 하드웨어 드라이버로 GPU에서 모델을 실행할 수 있습니다. CPU 프로세서가 아닌 다른 프로세서를 사용합니다.
BaseOptions를 통해 작업 옵션에서 GPU 위임을 구성합니다.
BaseOptions baseOptions = BaseOptions.builder().useGpu().build();
문제 해결
MediaPipe와 관련된 기술적 질문에 대한 도움말은 토론을 참조하세요. 그룹 또는 스택 다음에서 지원받을 수 있는 오버플로우 알게 되었습니다. 버그를 신고하거나 기능을 요청하려면 다음에서 문제를 제출하세요. GitHub를 참고하세요.
Android 개발 환경 설정에 도움이 필요한 경우 Android 개발자 문서를 참조하세요.