바코드 스캔
머신러닝을 활용하면 기기의 실시간 카메라로 대부분의 표준 바코드 형식으로 인코딩된 데이터를 읽을 수 있습니다.

사용 방법
바코드는 실제 세계의 복잡하거나 구조화된 데이터를 기기로 옮기는 간단하고 편리한 방법입니다. ML Kit의 바코드 스캔 API를 사용하면 사용자가 별도의 바코드 스캐너 앱으로 전환하지 않고도 앱에서 대부분의 표준 바코드 형식을 읽을 수 있습니다.
바코드 스캔은 구매할 제품 조회, 이벤트 세부정보 확인, 양식 작성 등 간단한 식별 및 콘텐츠 작업에서 사용자를 도울 수 있습니다.
이 디자인 가이드라인은 실시간 카메라 피드를 사용하는 바코드 스캔을 다룹니다.
원칙
이 기능의 디자인은 다음 원칙을 기반으로 합니다:
기기 카메라로 탐색
검색어를 입력하는 대신, 기기 카메라를 “리모컨”처럼 사용하여 바코드를 스캔합니다.
사용자가 카메라로 바코드를 스캔하는 방법을 익히도록 온보딩과 지속적인 안내를 제공하세요.
카메라 화면을 선명하고 읽기 쉽게 유지
카메라 UI 컴포넌트를 화면 상단과 하단 가장자리에 정렬하면 이미지 위에 배치되더라도 텍스트와 아이콘이 잘 읽히도록 유지할 수 있습니다.
실시간 카메라 피드 위에 표시되는 비대화형 요소는 카메라 피드를 가리는 영역을 최소화할 수 있도록 반투명해야 합니다.

피드백 제공
카메라로 바코드를 스캔하는 데는 고유한 사용성 요구 사항이 있습니다. 이미지 품질이 충분해야 하며, 사용자는 조명 불량이나 바코드에서 너무 멀어서 발생하는 이미지 문제를 해결하는 방법을 알고 있어야 합니다.
오류 상태는 여러 가지 디자인 수단(예: 컴포넌트와 모션)으로 전달해야 하며, 사용자가 검색을 개선할 수 있는 방법에 대한 안내를 포함해야 합니다.

컴포넌트
실시간 카메라 바코드 스캔은 기존 Material Design 컴포넌트와 카메라 상호작용에 특화된 새로운 요소를 함께 사용합니다. 새로운 요소(예: 바코드 프레임)의 코드 샘플과 데모는 Android용 ML Kit Material Design 쇼케이스 앱의 소스 코드에서 확인할 수 있습니다.

1. 상단 앱 바
2. 바코드 프레임
3. 툴팁
4. 모달 바텀 시트

상단 앱 바
상단 앱 바는 다음 항목에 대한 지속적인 액세스를 제공합니다:
- 검색 경험을 종료하는 버튼
- 밝기를 개선하는 토글(카메라 플래시 사용)
- 검색 문제를 해결하기 위한 도움말 섹션

권장
바코드 프레임
바코드 프레임은 화면 중앙에서 사용자가 바코드를 스캔할 수 있는 영역입니다. 기본적으로 프레임은 정사각형이지만, 앱이 지원하는 바코드 유형에 맞게 크기와 가로세로 비율을 조정해야 합니다.
프레임은 세 가지 용도로 사용됩니다:
- 확인: 프레임 모양이 바코드 하나의 크기에 맞춰져 있어 한 번에 한 개의 바코드만 스캔할 수 있음이 분명합니다.
- 가독성: 간단한 바코드 형식은 멀리서도 읽을 수 있지만, 복잡한 바코드 형식(예: PDF417)을 정확하게 읽으려면 더 가깝고 품질이 더 높은 이미지가 필요할 수 있습니다. 프레임 테두리를 일부만 표시하면 더 가까이 다가가야 스캔할 수 있음을 UI가 나타냅니다.
- 활동 표시: “센싱” 단계 동안 프레임 테두리가 펄스 애니메이션으로 깜빡이며 앱이 스캔할 바코드를 찾고 있음을 나타냅니다.
1. 센싱은 펄스 애니메이션을 사용하여 앱이 스캔할 바코드를 찾고 있음을 나타냅니다
2. 사용자가 바코드에 더 가까이 다가가야 함을 나타내기 위해 프레임 테두리를 일부만 표시하고 툴팁을 함께 표시합니다
3. 검색은 바코드 프레임을 가로지르는 확정되지 않은 진행 표시기로 표현됩니다
4. 오류가 발생하면 바코드 프레임 테두리가 실선에서 점선으로 바뀝니다
툴팁
툴팁은 사용자에게 정보성 텍스트를 표시합니다. 예를 들어 상태를 알릴 때는 “검색 중…”과 같은 메시지를, 다음 단계를 안내할 때는 “카메라를 바코드에 맞춰 주세요”와 같은 메시지를 표시합니다.

권장

권장하지 않음

권장하지 않음
모달 바텀 시트
모달 바텀 시트를 사용하면 사용자가 바코드 스캔 화면에 머무는 동안 바코드 정보에 접근할 수 있습니다. 바텀 시트의 레이아웃과 콘텐츠는 바코드가 반환하는 데이터 유형에 따라 달라집니다. 예를 들어:
- 구조화된 데이터(예: 연락처 정보)는 확인하고 편집할 수 있도록 텍스트 필드에 표시할 수 있습니다
- 데이터베이스에서 가져온 정보는 콘텐츠를 보여주기에 적합한 스타일로 표시해야 합니다. 콘텐츠 유형은 다양합니다. 예를 들어 소셜 미디어 콘텐츠는 소매 제품 콘텐츠와 구조가 다릅니다.
결과 표시
사용자가 앱의 다른 화면에서 작업을 완료하는 것이 더 빠르거나 쉽다면 모달 바텀 시트 대신 해당 화면에 바코드 정보를 표시하세요. 바코드 정보를 앱 내에서 언제, 어느 화면에 표시해야 하는지에 관한 자세한 내용은 경험 섹션을 참고하세요.


경험
실시간 카메라 바코드 스캔은 세 단계로 진행됩니다:
- 센싱: 카메라를 사용하여 스캔할 입력을 찾습니다
- 인식: 바코드를 감지합니다
- 전달: 바코드 결과를 현재 화면 또는 다른 화면에 표시합니다
센싱
“센싱”은 카메라가 실시간 카메라 피드에서 바코드를 찾는 단계입니다. 바코드 스캔은 사용자가 앱에서 바코드 기능을 열 때 시작됩니다.
이 단계 동안 앱은 다음을 수행해야 합니다:
- 기능이 작동하는 방식을 설명합니다
- 앱이 현재 수행 중인 동작을 알립니다
- 사용자가 카메라 조작 방식을 조정하도록 안내합니다
권장
권장
조정 안내
환경 조건 때문에 바코드를 스캔하기 어려울 수 있습니다. 예를 들어 너무 밝거나 너무 어두운 장소가 그렇습니다.

인식
카메라가 바코드를 감지하면 앱은 다음을 수행해야 합니다:
- 카메라 피드를 일시 중지하고 바코드 값을 읽습니다
- 구조화된 데이터라면 값을 즉시 표시합니다
- 바코드 값을 조회해야 한다면 조회를 진행하고 진행 상황을 표시합니다
이 단계에서는 카메라가 바코드를 감지하고 바코드 스캔 API가 바코드 값을 읽습니다. 다른 바코드가 스캔되지 않도록 카메라 피드는 일시 중지됩니다.
API에서 인식하는 구조화된 데이터(예: 위치 좌표, 캘린더 일정)가 담긴 바코드는 즉시 사용자에게 표시할 수 있습니다. 바코드의 데이터가 구조화되어 있지 않으면 상세 정보를 데이터베이스에서 가져옵니다. 앱은 이 정보를 가져오는 동안 로딩 상태를 표시합니다.
권장
권장
문제 수정하기
바코드가 감지되었다고 해서 앱이 반드시 결과를 찾을 수 있는 것은 아닙니다. 다음과 같은 문제가 발생할 수 있습니다:
- 관련 결과 없음: 성공적으로 스캔된 바코드가 앱이나 사용 사례와 관련된 정보를 담고 있지 않을 수 있습니다. 예를 들어 관련 없는 출처의 바코드를 스캔한 경우입니다.
- 네트워크 연결 끊김: 바코드 값을 온라인 데이터베이스에서 조회하는 경우 인터넷에 연결되어 있지 않으면 데이터 요청이 실패할 수 있습니다.
- 바코드 크기가 작음: 간단한 바코드 형식은 멀리서도 읽을 수 있지만, 복잡한 바코드 형식(예: PDF417)을 읽으려면 더 가깝고 품질이 더 높은 이미지가 필요할 수 있습니다. 스캔 전에 사용자가 바코드에 더 가까이 다가가야 함을 나타내려면 앱이 지원하는 바코드 형식의 최소 스캔 크기를 설정하고 여러 가지 디자인 수단(예: 바코드 프레임과 툴팁)을 사용하세요.

권장
권장
결과 전달
바코드 스캔 결과는 여러 가지 방식으로 표시될 수 있습니다:
- 카메라 화면 위(모달 바텀 시트 또는 대화상자)
- 바코드 스캔 기능을 종료한 후, 바코드 정보를 사용할 수 있는 화면
바코드 사용 사례에 맞게 UI를 조정하려면 다음 탐색 패턴과 컴포넌트를 사용하는 것이 좋습니다:
| 사용 사례 예시 | 바코드 스캔 화면에 머무르는가? | 결과 표시 위치 |
|---|---|---|
| 매장에서 제품 둘러보기 | 예 | 모달 바텀 시트 |
| 연락처 추가 | 예, 사용자가 저장할 때까지 | 모달 바텀 시트 또는 전체 화면 대화상자 |
| 양식 작성 | 아니요, 양식으로 돌아가기 | 사용자 대신 양식의 관련 필드를 채웁니다 |
권장
권장
권장
테마 설정
Shrine 머티리얼 테마
바코드 스캔은 Shrine 앱의 구매 흐름에서 사용됩니다.


바코드 프레임
Shrine의 바코드 프레임은 스크림에 On Primary 색상을 사용합니다. 프레임 테두리의 각진 모서리는 브랜드 로고의 기하학적 형태를 표현합니다.

2. Shrine의 바코드 프레임은 스크림 색상으로 Shrine Pink 900 (#442C2E)을 사용하며 각진 프레임 테두리가 있습니다.
툴팁
Shrine의 툴팁은 맞춤 색상, 타이포그래피, 배치를 사용하여 강조됩니다.

2. Shrine의 툴팁은 맞춤 색상과 타이포그래피를 사용하며 컨테이너가 화면 가장자리까지 확장됩니다.