Python 설정 가이드

이 페이지에서는 Python 애플리케이션에서 MediaPipe 태스크를 사용하도록 개발 환경을 설정하는 방법을 보여줍니다.

지원되는 플랫폼 및 버전

MediaPipe 태스크로 애플리케이션을 빌드하려면 다음과 같은 개발 환경 리소스가 필요합니다.

  • 운영체제:
    • 데스크톱: 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 태스크는 비전, 텍스트, 오디오를 위해 사전 빌드된 라이브러리 세 개를 제공합니다. 앱에서 사용하는 MediaPipe 태스크에 따라 비전, 텍스트 또는 오디오 라이브러리를 개발 프로젝트로 가져옵니다.

비전 작업

MediaPipe 태스크 비전 모듈에는 이미지 또는 동영상 입력을 처리하는 태스크가 포함되어 있습니다. MediaPipe Tasks 비전 라이브러리를 가져오려면 다음 종속 항목을 개발 프로젝트로 가져옵니다.

from mediapipe.tasks.python import vision

텍스트 작업

MediaPipe 태스크 텍스트 모듈에는 문자열 입력을 처리하는 태스크가 포함됩니다.MediaPipe 태스크 텍스트 라이브러리를 가져오려면 다음 종속 항목을 개발 프로젝트로 가져옵니다.

from mediapipe.tasks.python import text

오디오 작업

MediaPipe 작업 오디오 모듈에는 사운드 입력을 처리하는 작업이 포함됩니다. 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 개발자 가이드를 참조하세요.