모든 ML Kit 기능은 Google에서 학습시킨 머신러닝 모델( 기본적으로 사용됩니다. 이 가이드는 기본 모델에만 적용됩니다. 여기를 참고하세요. 커스텀 모델에 대한 안내를 참고하세요.
ML Kit API의 모델은 다음 세 가지 방법 중 하나로 설치할 수 있습니다.
- 번들되지 않음: Google Play 서비스를 통해 모델을 다운로드하고 관리합니다.
- 번들형: 빌드 시 모델이 정적으로 앱에 연결됩니다.
- 동적으로 다운로드됨: 모델이 요청 시 다운로드됩니다.
각 API에 지원되는 설치 경로
아래 표는 각 ML에서 지원되는 모델 설치 경로를 보여줍니다. 키트 기능:
번들되지 않음 | 번들형 | 동적으로 다운로드됨 | |
텍스트 인식 v2 | ✅ | ✅ | |
얼굴 인식 | ✅ | ✅ | |
얼굴 메시 감지 | ✅ | ||
자세 인식 | ✅ | ||
셀카 세분화 | ✅ | ||
바코드 스캔 | ✅ | ✅ | |
이미지 라벨 지정 | ✅ | ✅ | |
객체 감지 및 추적 | ✅ | ||
디지털 잉크 인식 | ✅ | ||
문서 스캐너 | ✅ | ||
주제 세분화 | ✅ | ||
Google 코드 스캐너 | ✅ | ||
언어 식별 | ✅ | ✅ | |
번역과 | ✅ | ||
스마트 답장 | ✅ | ✅ | |
항목 추출 | ✅ |
API별 가이드에서는 해당 클러스터에 사용할 수 있는 설치 옵션을 보여줍니다. API에 액세스할 수 있습니다.
설치 옵션 간의 주요 차이점
번들되지 않음 | 번들형 | 동적으로 다운로드됨 | |
모델은 어디에 저장되나요? | Google Play 서비스에 거주하며 스토리지에 포함되지 않음 이 앱에서 사용됨 | 앱별 저장소에 저장됨 설치 후 | 앱별 저장소에 저장됨 모델 다운로드 후 |
모델 크기가 앱 크기에 어떤 영향을 주나요? | 앱 크기에 영향을 미치지 않음 | 앱 크기에 직접적인 영향을 줌 | 앱 크기에는 영향을 미치지 않지만 앱별 저장용량 |
모델은 언제 업데이트되나요? | 최신 버전이 출시되면 자동으로 업데이트됩니다. | 모델을 업데이트하려면 앱을 업데이트해야 함 | 모델을 업데이트하려면 앱을 업데이트해야 함 |
모델은 언제 다운로드되나요? | 모델은 사용 전에 다운로드해야 함 | 앱 설치 시 모든 모델과 기능이 포함되므로 즉시 사용할 수 있음 | 모델 다운로드, 업데이트, 삭제는 다음을 사용하여 수동으로 관리해야 합니다. RemoteModelManager API |
언제 기기에서 모델이 삭제되나요? | 모든 앱이 Google Play 서비스에서 모델을 삭제하는 경우에만 스토리지에서 모델이 삭제됩니다. 모델을 기반으로 하는 애플리케이션이 제거됩니다. | 모델이 앱별 저장소에서 삭제됨 앱이 제거될 때 | 다운로드된 모델은 앱별 저장소에서 삭제됩니다. 앱이 제거될 때 |
번들 또는 번들 해제 중에서 선택하는 방법
API가 번들 설치 옵션과 번들 해제된 설치 옵션을 모두 지원하는 경우:
다음을 우선시하는 경우 번들 옵션을 사용하세요.
- 앱 설치 직후 기능 기능 완료
- 앱 설치 후 네트워크 연결 없이도 기능이 작동됩니다.
다음을 우선시하는 경우 번들로 묶이지 않음 옵션을 사용하세요.
- 앱 크기 축소
- Google Play 서비스를 통한 자동 모델 업데이트
모델을 다운로드하는 방법
번들로 묶이지 않은 모델 옵션을 사용하는 경우 모델 선택 방법을 지정할 수 있습니다. 다음 파일을 기기에 다운로드합니다.
선언을 추가하여 설치 시간 모델 다운로드를 사용 설정할 수 있습니다. 앱의
AndroidManifest.xml
파일에 있습니다. 예를 들어 아래의 코드 스니펫은 바코드를 자동으로 다운로드하도록 앱을 구성하는 방법을 보여줍니다. Play 스토어에서 앱을 설치한 후 스캔 모델:<application ...> ... <meta-data android:name="com.google.mlkit.vision.DEPENDENCIES" android:value="barcode" > <!-- To use multiple models: android:value="barcode,model2,model3" --> </application>
Google Play 서비스를 통해 선정적인 다운로드를 요청할 수 있습니다. ModuleInstallClient API:
설치 시간 모델 다운로드를 사용 설정하지 않거나 명시적인 다운로드되면 특성을 처음 실행할 때 모델이 다운로드됩니다. 다운로드가 완료될 때까지 추론 요청이 실패합니다.
모델을 업데이트하는 방법
번들 모델을 사용할 때 또는 동적으로 다운로드된 모델을 업데이트하기 위해 모델 옵션:
최신 ML Kit 기능 클라이언트를 사용하도록 앱의 Gradle 파일을 업데이트합니다. 있습니다.
dependencies { implementation 'com.google.mlkit:barcode-scanning: 17.3.0' // The latest version number of the API }
앱을 다시 빌드합니다.
일부 API에서 동적으로 다운로드된 모델을 제공하는 이유
일부 ML Kit API에는 번들로 묶을 수 있는 모델 옵션이 너무 많습니다. 예: 디지털 잉크 인식은 300개 이상의 이며 을 사용해야 합니다. 이를 위해 세 번째 설치 옵션을 제공합니다. 이 옵션은 설치 후 요청 시 다운로드됨 현재는 디지털 잉크만 인식, Translation 및 Entity 추출에는 이 옵션이 있습니다.