이 페이지에서는 Python 애플리케이션에서 MediaPipe 태스크를 사용하도록 개발 환경을 설정하는 방법을 보여줍니다.
지원되는 플랫폼 및 버전
MediaPipe Tasks로 애플리케이션을 빌드하려면 다음과 같은 개발 환경 리소스가 필요합니다.
- 운영체제:
- 데스크톱: 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 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 개발자 가이드를 참조하세요.