iOS 설정 가이드

이 페이지에서는 MediaPipe를 사용하도록 개발 환경을 설정하는 방법을 설명합니다. iOS 애플리케이션의 할 일 목록

지원되는 기기 및 플랫폼

개발 환경에서 MediaPipe Tasks로 iOS 애플리케이션을 만들려면 에는 다음이 필요합니다.

macOS Mojave 10.14.3 이상.
Xcode 10.3 이상
iOS 12.0 이상이 설치된 iOS 기기 또는 iOS 시뮬레이터는 기기 카메라가 필요하지 않은 애플리케이션을 처리합니다.

를 통해 개인정보처리방침을 정의할 수 있습니다.

개발자 환경 설정

iOS 애플리케이션에서 MediaPipe 작업을 실행하려면 먼저 Xcode 프로젝트를 새로 만들거나 로컬 머신에 새로 생성합니다.

MediaPipe 작업은 CocoaPods를 통해서만 설치할 수 있습니다. 시작하기 전에 CocoaPods 1.12.1 이상을 설치해야 합니다. 대상 macOS에 CocoaPods를 설치하는 방법에 대한 안내는 CocoaPods 설치 가이드를 참조하세요.

예시 코드 설정

MediaPipe 예시 저장소에는 MediaPipe 작업용 iOS 애플리케이션 예시가 포함되어 있습니다.

예시 코드에서 프로젝트를 만들고, 프로젝트를 빌드하고, 태스크에 맞추는 것입니다. 다음 단계에서는 Text 분류 기준 태스크에 맞추는 것입니다.

예시 코드 프로젝트를 가져와 빌드하는 방법은 다음과 같습니다.

터미널을 열고 MediaPipe 예시 저장소를 클론한 다음 TextClassifier.xcodeproj 및 Podfile가 포함된 디렉터리
```
git clone https://github.com/google-ai-edge/mediapipe-samples
cd mediapipe/examples/text_classification/ios
```
CocoaPods를 사용하여 MediaPipe 작업을 설치합니다.
```
pod install
```
이 명령어는 예시에 TextClassifier.xcworkspace 파일을 만듭니다. 프로젝트 디렉터리에 있습니다
TextClassifier.xcworkspace 파일을 더블클릭하여 프로젝트를 엽니다. Xcode TextClassifier.xcodeproj 파일이 이미 열려 있으면 닫습니다. TextClassifier.xcworkspace 파일을 열기 전
TextClassifier 스키마를 선택하고 실제 iOS 기기를 선택합니다. 시뮬레이터를 클릭합니다. 실제 iOS를 사용하는 경우 기기가 Mac에 연결되어 있는지 확인합니다.
프로젝트 툴바에서 Run 버튼을 클릭합니다.

Xcode에서 앱을 실행하는 방법에 대한 자세한 내용은 빌드 및 실행 - 앱을 엽니다.

MediaPipe 태스크 종속 항목

MediaPipe Tasks는 비전과 텍스트를 위해 미리 빌드된 두 개의 라이브러리를 제공합니다. 이 .tflite 모델 파일은 모델이 사용됩니다 MediaPipe Tas에 따라 비전 또는 텍스트를 추가합니다. 라이브러리를 CocoaPods Podfile 내의 포드 목록에 추가합니다. 자세한 내용은 앱에 필요한 포드로 Podfile를 만드는 방법은 CocoaPods.

생성형 AI 작업

MediaPipe Tasks 생성형 AI 라이브러리에는 이미지 또는 있습니다. MediaPipe Tasks 생성형 AI 라이브러리를 설치하려면 다음을 추가하세요. MediaPipeTasksGenAI 및 MediaPipeTasksGenAIC개의 포드를 다음 위치의 앱 타겟으로 Podfile

LLM 추론 API

MediaPipe LLM 추론 작업은 MediaPipeTasksGenAI 내에 포함되어 있습니다. 및 포드 MediaPipeTasksGenAIC개

target 'MyLlmInferenceApp' do
  use_frameworks!
  pod 'MediaPipeTasksGenAI'
  pod 'MediaPipeTasksGenAIC'
end

비전 작업

MediaPipe Tasks 비전 라이브러리에는 이미지 또는 동영상을 처리하는 작업이 포함되어 있습니다. 인코더-디코더입니다 MediaPipe Tasks 비전 라이브러리를 설치하려면 다음을 추가하세요. MediaPipeTasksVision 포드를 Podfile의 앱 타겟에 추가합니다.

target 'MyAppWithMediaPipeTasksVision' do
  use_frameworks!
  pod 'MediaPipeTasksVision'
end

텍스트 작업

MediaPipe Tasks 텍스트 라이브러리에는 있습니다. MediaPipe Tasks 텍스트 라이브러리를 설치하려면 다음을 추가합니다. MediaPipeTasksText 포드를 Podfile의 앱 타겟에 추가

target 'MyAppWithMediaPipeTasksText' do
  use_frameworks!
  pod 'MediaPipeTasksText'
end

테스트 대상 구성

앱에 테스트 타겟이 있는 경우 Podfile이 사용할 때 바람직하지 않은 동작을 방지하기 위해 MediaPipe 작업 라이브러리

가장 간단한 구현은 테스트 대상이 중첩되지 않도록 하는 것입니다. MediaPipe 작업 포드를 추가하는 기본 앱 타겟 내에서 이루어집니다.

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'
end

target 'MyAppWithMediaPipeTasksTests' do

end

테스트 타겟이 기본 앱 타겟 내에 중첩되어야 하는 경우 Podfile은 다음 구현을 준수해야 합니다.

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'

    target 'MyAppWithMediaPipeTasksTests' do
      inherit! :none

    end
end

BaseOptions 구성

BaseOptions는 MediaPipe Task API의 일반적인 구성을 허용합니다.

옵션 이름	설명	허용 값
`modelAssetPath`	iOS 애플리케이션 번들에 있는 모델 파일의 모델 경로입니다.	문자열 형식의 경로입니다.

하드웨어 가속

iOS에서 MediaPipe Tasks는 표준 CPU 프로세서에서 모델을 실행하는 것만 지원합니다.

문제 해결

MediaPipe와 관련된 기술적 질문에 대한 도움말은 토론을 참조하세요. 그룹 또는 스택 다음에서 지원받을 수 있는 오버플로우 알게 되었습니다. 버그를 신고하거나 기능을 요청하려면 다음에서 문제를 제출하세요. GitHub를 참고하세요.

iOS 개발 환경 설정과 관련하여 도움이 필요한 경우 Apple 개발자 문서를 참조하세요.