Skip to content
Material Design 2
Main Navigation
v3
v2
v1

한국어

English
简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
Italiano
Polski
Türkçe
čeština
magyar

한국어

English
简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
Italiano
Polski
Türkçe
čeština
magyar

외관

Sidebar Navigation

Material 시스템

소개

머티리얼 스터디

머티리얼 스터디 소개

Basil

Crane

Fortnightly

Owl

Rally

Reply

Shrine

Material 기초

환경

표면

엘리베이션

빛과 그림자

레이아웃

레이아웃 이해하기

픽셀 밀도

반응형 레이아웃 그리드

간격 방법

컴포넌트 동작

밀도 적용

내비게이션

내비게이션 이해

내비게이션 전환

검색

색상

색상 시스템

UI에 색상 적용하기

색상 사용

텍스트 가독성

다크 테마

타이포그래피

타입 시스템

타이포그래피 이해하기

언어 지원

사운드

사운드 소개

UI에 사운드 적용

사운드 속성

사운드 연출

아이코노그래피

제품 아이콘

시스템 아이콘

애니메이션 아이콘

모양

모양 소개

모양과 계층 구조

표현 수단으로서의 모양

모양과 모션(Shape and motion)

UI에 모양 적용하기

모션

모션 이해하기

모션 시스템

속도

코레오그래피(Choreography)

맞춤 설정

상호작용

제스처

선택

상태

커뮤니케이션

확인 및 알림

데이터 형식

데이터 시각화

빈 상태

도움말 및 피드백

이미지

시작 화면

온보딩

오프라인 상태

작성 지침

머신러닝

머신러닝 패턴

객체 감지: 실시간 카메라

객체 감지: 정적 이미지

바코드 스캔

Material 가이드라인

Material Theming

개요

테마 구현

사용성

접근성

양방향성

플랫폼 가이드라인

Android 바

Android 지문

Android 햅틱

Android 아이콘

Android 앱 간 이동

Android 알림

Android 권한

Android 슬라이스

Android 분할 화면

Android 당겨서 새로고침

Android 텍스트 선택 툴바

Android 위젯

크로스 플랫폼 적응

컴포넌트

앱 바: 하단

앱 바: 상단

백드롭

배너

하단 내비게이션

버튼

버튼: 플로팅 작업 버튼

카드

체크박스

칩

데이터 표

날짜 선택기

대화상자

구분선

이미지 목록

목록

메뉴

내비게이션 드로어

탐색 레일

진행 표시기

라디오 버튼

바텀 시트

시트: 사이드

슬라이더

스낵바

스위치

탭

텍스트 필드

시간 선택기

툴팁

이 페이지에서

바코드 스캔 ​

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

바코드 스캔 대표 이미지

사용 방법 ​

바코드는 실제 세계의 복잡하거나 구조화된 데이터를 기기로 옮기는 간단하고 편리한 방법입니다. ML Kit의 바코드 스캔 API를 사용하면 사용자가 별도의 바코드 스캐너 앱으로 전환하지 않고도 앱에서 대부분의 표준 바코드 형식을 읽을 수 있습니다.

바코드 스캔은 구매할 제품 조회, 이벤트 세부정보 확인, 양식 작성 등 간단한 식별 및 콘텐츠 작업에서 사용자를 도울 수 있습니다.

이 디자인 가이드라인은 실시간 카메라 피드를 사용하는 바코드 스캔을 다룹니다.

바코드 스캔은 사용자가 제품 정보를 수동으로 검색하거나 데이터를 직접 입력하는 대신 사용할 수 있는 편리한 방법을 제공합니다.

ML Kit API 문서

바코드 스캔 개발자 가이드

관련 문서

예시 – Android

Android용 ML Kit 쇼케이스 앱

관련 문서

원칙 ​

이 기능의 디자인은 다음 원칙을 기반으로 합니다:

기기 카메라로 탐색

검색어를 입력하는 대신, 기기 카메라를 “리모컨”처럼 사용하여 바코드를 스캔합니다.

사용자가 카메라로 바코드를 스캔하는 방법을 익히도록 온보딩과 지속적인 안내를 제공하세요.

간결한 애니메이션 온보딩으로 사용자가 기기 카메라를 올바른 위치에 두도록 안내하여 바코드를 스캔하는 방법을 설명할 수 있습니다.

카메라 화면을 선명하고 읽기 쉽게 유지

카메라 UI 컴포넌트를 화면 상단과 하단 가장자리에 정렬하면 이미지 위에 배치되더라도 텍스트와 아이콘이 잘 읽히도록 유지할 수 있습니다.

실시간 카메라 피드 위에 표시되는 비대화형 요소는 카메라 피드를 가리는 영역을 최소화할 수 있도록 반투명해야 합니다.

카메라 피드를 최대한 넓게 볼 수 있도록 경험의 요소 대부분이 화면 상단과 하단 가장자리를 따라 배치된 모습
카메라 피드를 최대한 넓게 볼 수 있도록 경험의 요소 대부분은 화면 상단과 하단 가장자리를 따라 배치됩니다.

피드백 제공

카메라로 바코드를 스캔하는 데는 고유한 사용성 요구 사항이 있습니다. 이미지 품질이 충분해야 하며, 사용자는 조명 불량이나 바코드에서 너무 멀어서 발생하는 이미지 문제를 해결하는 방법을 알고 있어야 합니다.

오류 상태는 여러 가지 디자인 수단(예: 컴포넌트와 모션)으로 전달해야 하며, 사용자가 검색을 개선할 수 있는 방법에 대한 안내를 포함해야 합니다.

사용자가 바코드 스캔을 "완료"하려면 더 가까이 다가가야 함을 바코드 프레임과 툴팁이 모두 표시하는 모습
바코드 프레임과 툴팁 모두 사용자가 바코드 스캔을 “완료”하려면 더 가까이 다가가야 함을 나타냅니다.

컴포넌트 ​

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

바코드 스캔 경험의 단계별 주요 요소
바코드 스캔 경험의 단계별 주요 요소:
1. 상단 앱 바
2. 바코드 프레임
3. 툴팁
4. 모달 바텀 시트
컴포넌트

예시 – Android

Android용 ML Kit 쇼케이스 앱

관련 문서

상단 앱 바 ​


상단 앱 바는 다음 항목에 대한 지속적인 액세스를 제공합니다:

  • 검색 경험을 종료하는 버튼
  • 밝기를 개선하는 토글(카메라 플래시 사용)
  • 검색 문제를 해결하기 위한 도움말 섹션
권장: 카메라 피드 위에서도 상단 앱 바의 작업이 잘 보이도록 컨테이너에 그라디언트 스크림 또는 단색을 사용한 모습

권장

카메라 피드 위에서도 상단 앱 바의 작업이 잘 보이도록 컨테이너에 그라디언트 스크림 또는 단색을 사용하세요.

상단 앱 바

상단 앱 바는 현재 화면과 관련된 정보와 작업을 표시합니다.

관련 문서

바코드 프레임 ​

바코드 프레임은 화면 중앙에서 사용자가 바코드를 스캔할 수 있는 영역입니다. 기본적으로 프레임은 정사각형이지만, 앱이 지원하는 바코드 유형에 맞게 크기와 가로세로 비율을 조정해야 합니다.

프레임은 세 가지 용도로 사용됩니다:

  1. 확인: 프레임 모양이 바코드 하나의 크기에 맞춰져 있어 한 번에 한 개의 바코드만 스캔할 수 있음이 분명합니다.
  2. 가독성: 간단한 바코드 형식은 멀리서도 읽을 수 있지만, 복잡한 바코드 형식(예: PDF417)을 정확하게 읽으려면 더 가깝고 품질이 더 높은 이미지가 필요할 수 있습니다. 프레임 테두리를 일부만 표시하면 더 가까이 다가가야 스캔할 수 있음을 UI가 나타냅니다.
  3. 활동 표시: “센싱” 단계 동안 프레임 테두리가 펄스 애니메이션으로 깜빡이며 앱이 스캔할 바코드를 찾고 있음을 나타냅니다.
바코드 프레임은 바코드를 스캔해야 하는 위치, 확대가 필요한지 여부, 현재 스캔 상태를 보여주는 애니메이션 가이드를 제공합니다.

바코드 프레임의 상태:

1. 센싱은 펄스 애니메이션을 사용하여 앱이 스캔할 바코드를 찾고 있음을 나타냅니다
2. 사용자가 바코드에 더 가까이 다가가야 함을 나타내기 위해 프레임 테두리를 일부만 표시하고 툴팁을 함께 표시합니다
3. 검색은 바코드 프레임을 가로지르는 확정되지 않은 진행 표시기로 표현됩니다
4. 오류가 발생하면 바코드 프레임 테두리가 실선에서 점선으로 바뀝니다

툴팁 ​

툴팁은 사용자에게 정보성 텍스트를 표시합니다. 예를 들어 상태를 알릴 때는 “검색 중…”과 같은 메시지를, 다음 단계를 안내할 때는 “카메라를 바코드에 맞춰 주세요”와 같은 메시지를 표시합니다.

권장: 사용자에게 익숙한 용어로 짧은 메시지를 작성한 모습

권장

사용자에게 익숙한 용어로 짧은 메시지를 작성하세요.
툴팁은 상호작용 요소가 아니므로 "탭하여 검색"과 같이 행동을 유도하는 동사가 포함된 툴팁의 사례

권장하지 않음

툴팁은 상호작용 요소가 아니므로 “탭하여 검색”과 같이 행동을 유도하는 동사가 포함된 툴팁은 작성하지 마세요.

툴팁에 배치된 오류 메시지의 사례

권장하지 않음

오류 메시지를 툴팁에 넣지 마세요. 오류는 배너에 표시해야 합니다. 배너는 강조 효과가 더 크고 작업 버튼을 표시할 공간도 확보할 수 있습니다.

툴팁

사용자가 요소 위에 마우스를 올리거나, 포커스하거나, 탭할 때 정보성 텍스트를 표시합니다

관련 문서

모달 바텀 시트 ​

모달 바텀 시트를 사용하면 사용자가 바코드 스캔 화면에 머무는 동안 바코드 정보에 접근할 수 있습니다. 바텀 시트의 레이아웃과 콘텐츠는 바코드가 반환하는 데이터 유형에 따라 달라집니다. 예를 들어:

  • 구조화된 데이터(예: 연락처 정보)는 확인하고 편집할 수 있도록 텍스트 필드에 표시할 수 있습니다
  • 데이터베이스에서 가져온 정보는 콘텐츠를 보여주기에 적합한 스타일로 표시해야 합니다. 콘텐츠 유형은 다양합니다. 예를 들어 소셜 미디어 콘텐츠는 소매 제품 콘텐츠와 구조가 다릅니다.

결과 표시 ​

사용자가 앱의 다른 화면에서 작업을 완료하는 것이 더 빠르거나 쉽다면 모달 바텀 시트 대신 해당 화면에 바코드 정보를 표시하세요. 바코드 정보를 앱 내에서 언제, 어느 화면에 표시해야 하는지에 관한 자세한 내용은 경험 섹션을 참고하세요.

바텀 시트에서 구조화된 데이터를 표시하기에 적합한 텍스트 필드의 모습
텍스트 필드는 바텀 시트에서 구조화된 데이터를 표시하기에 적합합니다. 각 필드의 레이블과 입력값으로 데이터의 “키”와 “값”(예: Wi-Fi 네트워크 이름)을 보여줄 수 있습니다.
바코드 정보에 맞게 맞춤 설정된 모달 바텀 시트 레이아웃의 모습
모달 바텀 시트의 레이아웃은 소셜 미디어 사용자 프로필과 같은 바코드 정보에 맞게 맞춤 설정할 수 있습니다.

바텀 시트

화면 하단에 고정되며 보충 콘텐츠를 담는 표면입니다.

관련 문서

경험 ​

실시간 카메라 바코드 스캔은 세 단계로 진행됩니다:

  1. 센싱: 카메라를 사용하여 스캔할 입력을 찾습니다
  2. 인식: 바코드를 감지합니다
  3. 전달: 바코드 결과를 현재 화면 또는 다른 화면에 표시합니다

센싱 ​

“센싱”은 카메라가 실시간 카메라 피드에서 바코드를 찾는 단계입니다. 바코드 스캔은 사용자가 앱에서 바코드 기능을 열 때 시작됩니다.

이 단계 동안 앱은 다음을 수행해야 합니다:

  • 기능이 작동하는 방식을 설명합니다
  • 앱이 현재 수행 중인 동작을 알립니다
  • 사용자가 카메라 조작 방식을 조정하도록 안내합니다

권장

한 화면 분량의 온보딩으로 상호작용 방식을 설명하세요. 사용자에게 기기를 움직이는 방법을 보여줄 때는 애니메이션을 사용하는 것이 좋습니다.

권장

앱이 바코드를 찾고 있음을 알리세요. 바코드 프레임은 펄스 애니메이션을 사용하여 앱이 카메라 피드를 “스캔”하고 있음을 나타내고, 사용자에게 바코드를 프레임 중앙에 맞추라고 안내하는 툴팁을 함께 표시합니다.

조정 안내

환경 조건 때문에 바코드를 스캔하기 어려울 수 있습니다. 예를 들어 너무 밝거나 너무 어두운 장소가 그렇습니다.

도움말 섹션이 사용자가 스캔 중 문제를 파악하고 해결하도록 돕는 모습
도움말 섹션은 사용자가 스캔 중 문제를 파악하고 해결하도록 도울 수 있습니다. 올바른 카메라 각도, 거리, 조명 조건과 같은 주제를 다루는 안내 콘텐츠를 제공할 수 있습니다.

인식 ​

카메라가 바코드를 감지하면 앱은 다음을 수행해야 합니다:

  1. 카메라 피드를 일시 중지하고 바코드 값을 읽습니다
  2. 구조화된 데이터라면 값을 즉시 표시합니다
  3. 바코드 값을 조회해야 한다면 조회를 진행하고 진행 상황을 표시합니다

이 단계에서는 카메라가 바코드를 감지하고 바코드 스캔 API가 바코드 값을 읽습니다. 다른 바코드가 스캔되지 않도록 카메라 피드는 일시 중지됩니다.

API에서 인식하는 구조화된 데이터(예: 위치 좌표, 캘린더 일정)가 담긴 바코드는 즉시 사용자에게 표시할 수 있습니다. 바코드의 데이터가 구조화되어 있지 않으면 상세 정보를 데이터베이스에서 가져옵니다. 앱은 이 정보를 가져오는 동안 로딩 상태를 표시합니다.

권장

여러 가지 디자인 수단을 사용하여 지원되는 바코드가 감지되었음을 알리세요. 카메라 피드가 일시 중지되는 동안 바코드 프레임의 테두리가 투명에서 불투명으로 바뀝니다.

권장

앱이 바코드 값을 조회해야 하는 경우 결과가 준비되고 있음을 알리기 위해 확정되지 않은 진행 표시기와 툴팁 메시지를 표시하세요.

문제 수정하기 ​

바코드가 감지되었다고 해서 앱이 반드시 결과를 찾을 수 있는 것은 아닙니다. 다음과 같은 문제가 발생할 수 있습니다:

  • 관련 결과 없음: 성공적으로 스캔된 바코드가 앱이나 사용 사례와 관련된 정보를 담고 있지 않을 수 있습니다. 예를 들어 관련 없는 출처의 바코드를 스캔한 경우입니다.
  • 네트워크 연결 끊김: 바코드 값을 온라인 데이터베이스에서 조회하는 경우 인터넷에 연결되어 있지 않으면 데이터 요청이 실패할 수 있습니다.
  • 바코드 크기가 작음: 간단한 바코드 형식은 멀리서도 읽을 수 있지만, 복잡한 바코드 형식(예: PDF417)을 읽으려면 더 가깝고 품질이 더 높은 이미지가 필요할 수 있습니다. 스캔 전에 사용자가 바코드에 더 가까이 다가가야 함을 나타내려면 앱이 지원하는 바코드 형식의 최소 스캔 크기를 설정하고 여러 가지 디자인 수단(예: 바코드 프레임과 툴팁)을 사용하세요.

권장: 일치하는 결과가 없을 경우 배너를 사용하는 모습

권장

일치하는 결과가 없을 경우 배너로 알리세요. 전용 도움말 섹션으로 이동하거나 다른 이미지로 다시 시도할 수 있는 옵션을 제공하세요.

권장

정확하게 스캔되도록 앱이 지원하는 바코드 형식의 최소 스캔 크기를 설정하세요. 바코드가 최소 스캔 크기를 충족할 때까지 사용자에게 더 가까이 다가가라고 안내하세요.

오류 + 자연스러운 실패 처리

ML 오류를 처리하는 방법

관련 문서

결과 전달 ​

바코드 스캔 결과는 여러 가지 방식으로 표시될 수 있습니다:

  • 카메라 화면 위(모달 바텀 시트 또는 대화상자)
  • 바코드 스캔 기능을 종료한 후, 바코드 정보를 사용할 수 있는 화면

바코드 사용 사례에 맞게 UI를 조정하려면 다음 탐색 패턴과 컴포넌트를 사용하는 것이 좋습니다:

사용 사례 예시바코드 스캔 화면에 머무르는가?결과 표시 위치
매장에서 제품 둘러보기예모달 바텀 시트
연락처 추가예, 사용자가 저장할 때까지모달 바텀 시트 또는 전체 화면 대화상자
양식 작성아니요, 양식으로 돌아가기사용자 대신 양식의 관련 필드를 채웁니다

권장

사용자가 스캔 화면을 다시 열지 않고도 더 많은 항목을 스캔할 수 있도록 바코드 결과를 카메라 피드 위에 표시하세요.

권장

정보(예: 새 연락처)의 편집과 저장은 바코드 스캔 화면에서 빠르게 처리할 수 있습니다. 구조화된 데이터를 편집 가능한 텍스트 필드로 표시하고, 저장한 후 스캔을 종료하는 옵션을 제공하세요.

권장

바코드를 스캔하면 양식 필드를 직접 작성하지 않아도 됩니다. 스캔에 성공하면 작업을 완료할 수 있도록 사용자를 양식으로 돌려보내세요.

테마 설정 ​

Shrine 머티리얼 테마 ​

바코드 스캔은 Shrine 앱의 구매 흐름에서 사용됩니다.

Shrine의 바코드 스크림과 툴팁 텍스트는 밝은 배경과 대비되는 어두운 색상으로 강조된 모습
Shrine의 바코드 스크림과 툴팁 텍스트는 밝은 배경과 대비되는 어두운 색상으로 강조됩니다.
시각적 검색 결과는 Shrine의 브랜드 색상, 타이포그래피, 모양 스타일을 사용한 모습
시각적 검색 결과는 Shrine의 브랜드 색상, 타이포그래피, 모양 스타일을 사용합니다.

바코드 프레임 ​

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

기본 바코드 프레임은 스크림 색상으로 #000000을 사용하며 둥근 프레임 테두리가 있는 모습
1. 기본 바코드 프레임은 스크림 색상으로 #000000을 사용하며 둥근 프레임 테두리가 있습니다.
2. Shrine의 바코드 프레임은 스크림 색상으로 Shrine Pink 900 (#442C2E)을 사용하며 각진 프레임 테두리가 있습니다.

툴팁 ​

Shrine의 툴팁은 맞춤 색상, 타이포그래피, 배치를 사용하여 강조됩니다.

툴팁은 일반적으로 주목도가 낮은 컴포넌트로 너비가 텍스트에 따라 결정되는 모습
1. 툴팁은 일반적으로 주목도가 낮은 컴포넌트로, 너비가 텍스트에 따라 결정됩니다.
2. Shrine의 툴팁은 맞춤 색상과 타이포그래피를 사용하며 컨테이너가 화면 가장자리까지 확장됩니다.

Shrine

Shrine은 Material Design이 전자상거래에서 어떻게 활용될 수 있는지 보여주는 라이프스타일 및 패션 브랜드입니다.

관련 문서

Pager
이전객체 감지: 정적 이미지
다음개요

Apache-2.0 라이선스 하에 배포되었습니다.

Copyright © 2018-Present Google

https://m2.material.io/design/machine-learning/barcode-scanning.html

Apache-2.0 라이선스 하에 배포되었습니다.

Copyright © 2018-Present Google