사용자가 실제 문서를 디지털 형식으로 변환할 수 있는 실제 문서를 디지털화하는 작업이 모바일 앱에서 매우 일반적인 사용자 여정이 되었습니다.
ML Kit의 문서 스캐너 API는 Android 앱과 기기 전반에서 고품질의 일관된 UI 흐름을 제공하는 포괄적인 솔루션을 제공합니다. 앱에서 문서 스캐너 흐름이 트리거되면 사용자는 스캔 프로세스를 완전히 제어할 수 있습니다. 원하는 경우 스캔된 문서를 자르고, 필터를 적용하고, 그림자나 얼룩을 제거하고, 디지털화된 파일을 쉽게 앱으로 다시 전송할 수 있습니다.
UI 흐름, ML 모델 및 기타 대규모 리소스는 Google Play 서비스를 통해 제공됩니다. 즉,
바이너리 크기의 영향이 적음 (모든 ML 모델과 대용량 리소스가 Google Play 서비스의 중앙에서 다운로드됨)
카메라 권한은 필요하지 않습니다. 문서 스캐너는 Google Play 서비스의 카메라 권한을 활용하며 사용자는 앱과 다시 공유할 파일을 제어할 수 있습니다.
자르기, 필터 적용, 그림자 제거, 얼룩 제거, 디지털화된 파일을 앱으로 원활하게 다시 전송하는 수정 기능
기기 내 처리로 사용자 개인 정보 보호
앱의 카메라 권한이 필요하지 않습니다.
APK 바이너리 크기에 미치는 영향이 낮습니다.
맞춤설정
Document Scanner API는 Android 앱 전체에서 일관된 고품질의 완전한 UI 흐름을 제공합니다. 그러나 사용자 환경의 일부 측면을 맞춤설정할 수도 있습니다.
최대 페이지 수:
스캔되는 페이지 수를 제한합니다.
갤러리 가져오기:
사진 갤러리에서 가져오는 기능을 사용 설정 또는 사용 중지합니다.
수정 기능:
다음 3가지 모드 중에서 선택하여 사용자가 사용할 수 있는 수정 기능을 맞춤설정합니다.
SCANNER_MODE_BASE: 기본 수정 기능 (자르기, 회전, 페이지 재정렬 등)
SCANNER_MODE_BASE_WITH_FILTER: 이미지 필터 (그레이 스케일, 자동 이미지 보정 등)를 SCANNER_MODE_BASE 모드에 추가합니다.
SCANNER_MODE_FULL (기본값): ML 지원 이미지 정리 기능 (얼룩, 손가락 지우기 등)을 SCANNER_MODE_BASE_WITH_FILTER 모드에 추가합니다. 또한 이 모드를 사용하면 향후 주요 기능이 Google Play 서비스 업데이트와 함께 자동으로 추가되지만, 나머지 두 모드는 현재 기능 집합을 유지하며 사소한 개선만 수신합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eML Kit's Document Scanner API enables digitization of physical documents within Android apps, providing a high-quality and consistent user interface.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers on-device processing, ensuring user privacy and eliminating the need for camera permissions from the app.\u003c/p\u003e\n"],["\u003cp\u003eUsers have control over the scanning process, including cropping, applying filters, removing imperfections, and sharing the digitized files.\u003c/p\u003e\n"],["\u003cp\u003eCustomization options are available to tailor the user experience, such as limiting pages, enabling gallery imports, and adjusting editing functionalities.\u003c/p\u003e\n"],["\u003cp\u003eThe API leverages Google Play services for model delivery, minimizing app size and enabling automatic updates for enhanced features.\u003c/p\u003e\n"]]],["The document scanner API allows users to digitize physical documents within Android apps. Key actions include automatic document capture, edge and rotation detection, and editing features like cropping, filtering, and stain/shadow removal. The API operates on-device and uses Google Play services, ensuring low binary size impact and eliminating the need for camera permissions. Customization options are provided for the maximum number of pages, gallery import, and three editing modes, with the full mode offering the most feature set.\n"],null,["Document scanner\n----------------\n\n| This API is offered in beta, and is not subject to any SLA or deprecation policy. Changes may be made to this API that break backward compatibility.\n\nDigitizing physical documents, which allows users to convert physical documents\ninto digital formats has become a very common user journey in mobile apps.\nML Kit's document scanner API provides a comprehensive solution with a\nhigh-quality, consistent UI flow across Android apps and devices. Once the\ndocument scanner flow is triggered from your app, users retain full control over\nthe scanning process. They can optionally crop the scanned documents, apply\nfilters, remove shadows or stains, and easily send the digitized files back to\nyour app.\n\nThe UI flow, ML models and other large resources are delivered using Google Play\nservices, which means:\n\n- Low binary size impact (all ML models and large resources are downloaded centrally in Google Play services).\n- No camera permission is required - the document scanner leverages the Google Play services' camera permission, and users are in control of which files to share back with your app.\n\nThe entire document scanner flow operates on-device.\n\n[Android](/ml-kit/vision/doc-scanner/android)\n\n### Key capabilities\n\n- High-quality and consistent user interface for digitizing physical documents.\n- Automatic capture with document detection.\n- Accurate edge detection for optimal crop results.\n- Automatic rotation detection to show documents upright.\n- Editing functionalities to crop, apply filters, remove shadows, clean stains, and seamlessly send digitized files back to your app.\n- On-device processing, preserving user's privacy.\n- No camera permission is needed from your app.\n- Low apk binary size impact.\n\n### Customization\n\nThe document scanner API provides a high-quality fully fledged UI flow that is\nconsistent across Android apps. However, there is also room to customize some\naspects of the user experience:\n\n- **Maximum number of pages:** \n\n Set a limit to the number of pages scanned.\n\n- **Gallery import:** \n\n Enable or disable the capability to import from the photo gallery.\n\n- **Editing functionalities:** \n\n Customize the editing functionalities available to the user by choosing\n from 3 modes:\n\n - `SCANNER_MODE_BASE`: basic editing capabilities (crop, rotate, reorder pages, etc...).\n - `SCANNER_MODE_BASE_WITH_FILTER`: adds image filters (grayscale, auto image enhancement, etc...) to the `SCANNER_MODE_BASE` mode.\n - `SCANNER_MODE_FULL` (default): adds ML-enabled image cleaning capabilities (erase stains, fingers, etc...) to the `SCANNER_MODE_BASE_WITH_FILTER` mode. This mode will also allow future major features to be automatically added along with Google Play services updates, while the other two modes will maintain their current feature sets and only receive minor refinements.\n\n| Base mode | Base mode with filter | Full mode |\n|-----------|-----------------------|-----------|\n| | | |\n\n### Example results\n\n| Original picture | Scanned document with perspective corrected, wrinkle removed and grayscale filter applied |\n|------------------|-------------------------------------------------------------------------------------------|\n| | |\n\n| Original picture | Scanned document auto-rotated with stain removed and color filter applied |\n|------------------|---------------------------------------------------------------------------|\n| | |\n\n| Original picture | Scanned document with stain removed and auto filter applied |\n|------------------|-------------------------------------------------------------|\n| | |\n\n| Original picture | Scanned document auto-rotated with shadow removed and auto filter applied |\n|------------------|---------------------------------------------------------------------------|\n| | |\n\n| Original picture | Scanned document auto-rotated with finger removed and auto filter applied |\n|------------------|---------------------------------------------------------------------------|\n| | |"]]
