Android의 ML Kit 모델 설치 경로

모든 ML Kit 기능은 Google에서 학습시킨 머신러닝 모델( 기본적으로 사용됩니다. 이 가이드는 기본 모델에만 적용됩니다. 여기를 참고하세요. 커스텀 모델에 대한 안내를 참고하세요.

ML Kit API의 모델은 다음 세 가지 방법 중 하나로 설치할 수 있습니다.

  1. 번들되지 않음: Google Play 서비스를 통해 모델을 다운로드하고 관리합니다.
  2. 번들형: 빌드 시 모델이 정적으로 앱에 연결됩니다.
  3. 동적으로 다운로드됨: 모델이 요청 시 다운로드됩니다.

각 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:

  • 설치 시간 모델 다운로드를 사용 설정하지 않거나 명시적인 다운로드되면 특성을 처음 실행할 때 모델이 다운로드됩니다. 다운로드가 완료될 때까지 추론 요청이 실패합니다.

모델을 업데이트하는 방법

번들 모델을 사용할 때 또는 동적으로 다운로드된 모델을 업데이트하기 위해 모델 옵션:

  1. 최신 ML Kit 기능 클라이언트를 사용하도록 앱의 Gradle 파일을 업데이트합니다. 있습니다.

    dependencies {
      implementation 'com.google.mlkit:barcode-scanning: 17.3.0' // The latest version number of the API
    }
    
  2. 앱을 다시 빌드합니다.

일부 API에서 동적으로 다운로드된 모델을 제공하는 이유

일부 ML Kit API에는 번들로 묶을 수 있는 모델 옵션이 너무 많습니다. 예: 디지털 잉크 인식300개 이상의 이며 을 사용해야 합니다. 이를 위해 세 번째 설치 옵션을 제공합니다. 이 옵션은 설치 후 요청 시 다운로드됨 현재는 디지털 잉크만 인식, TranslationEntity 추출에는 이 옵션이 있습니다.