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의 “정적” 모드를 사용하면 제공된 이미지에서 최대 5개의 객체를 감지하고, 자체 이미지 분류 모델로 일치하는 결과를 표시할 수 있습니다.

이미지에서 객체를 검색하면 사용자가 여러 항목에 대한 결과를 탐색할 수 있습니다.

ML Kit API 문서

객체 감지 개발자 가이드

관련 문서

예시 – Android

Android용 ML Kit 쇼케이스 앱

관련 문서

예시 – iOS

iOS용 ML Kit 쇼케이스 앱

관련 문서

원칙 ​

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

이미지를 선명하게 유지

카메라 UI 컴포넌트를 화면의 상단 및 하단 가장자리에 정렬하면, 이미지 위에 배치된 텍스트와 아이콘의 가독성이 항상 유지됩니다.

실시간 카메라 피드 위에 표시되는 비상호작용 요소는 카메라 화면을 가리지 않도록 반투명하게 표시해야 합니다.

이미지가 최대한 잘 보이도록 대부분의 컴포넌트는 화면의 상단 및 하단 가장자리에 배치됩니다
이미지가 최대한 잘 보이도록 대부분의 컴포넌트는 화면의 상단 및 하단 가장자리에 배치됩니다.

피드백 제공

이미지를 사용한 객체 검색에는 고유한 사용성 요구사항이 따릅니다. 객체가 서로 겹치거나 잘려 있으면 식별하기 어려울 수 있습니다.

오류 상태는 다양한 디자인 수단 (예: 컴포넌트, 모션)으로 전달해야 하며, 사용자가 검색을 개선할 수 있는 방법을 안내하는 설명을 함께 제공해야 합니다.

배너는 검색에 문제가 발생했음을 사용자에게 눈에 띄게 알리는 방법을 제공합니다
배너는 검색에 문제가 발생했음을 눈에 띄게 알리고, 자세한 정보를 담은 도움말 섹션으로 연결할 공간도 제공합니다.

컴포넌트 ​

정적 이미지 객체 감지 기능은 기존 Material Design 컴포넌트와, 이미지 상호작용에 특화된 새로운 요소를 함께 사용합니다. 새로운 요소 (예: 객체 마커)의 코드 샘플과 데모는 Android용 ML Kit Material Design 쇼케이스 앱의 소스 코드를 참고하세요.

정적 이미지 시각적 검색의 단계별 핵심 요소
정적 이미지 시각적 검색의 단계별 핵심 요소:
1. 상단 앱 바
2. 객체 마커
3. 툴팁
4. 카드
5. 감지된 이미지
6. 모달 바텀 시트
컴포넌트: 핵심 요소

상단 앱 바 ​

상단 앱 바는 다음 작업을 항상 제공해야 합니다:

  • 검색 화면을 종료하는 버튼
  • 카메라 플래시를 사용해 밝기를 높이는 토글
  • 검색 문제 해결을 위한 도움말 섹션
권장: 카메라 피드 위에서도 상단 앱 바 버튼이 잘 보이도록 앱 바 컨테이너에 그라데이션 스크림 또는 단색을 사용하세요

권장

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

상단 앱 바

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

관련 문서

객체 마커 ​

객체 마커는 감지된 객체의 중심 위에 배치되는 입체적인 원형 표시기입니다. 각 마커는 화면 하단의 카드와 짝을 이루며, 이 카드에는 해당 객체의 결과 미리보기가 표시됩니다. 카드가 스크롤되어 화면에 나타나면 짝을 이루는 객체 마커의 크기가 커집니다.

객체 마커 (또는 결과 카드)를 탭하면 객체의 전체 시각적 검색 결과를 표시하는 모달 바텀 시트가 열립니다.

객체 마커는 사용자의 주의를 끌기 위해 애니메이션 효과와 함께 이미지 위에 나타납니다.

툴팁 ​

툴팁은 사용자에게 안내 텍스트를 표시합니다. 예를 들어 “검색 중…”과 같은 메시지로 현재 상태를 알리거나, “결과를 보려면 마커나 카드를 탭하세요”와 같은 메시지로 다음 단계를 안내할 수 있습니다.

권장: 대상 사용자에게 맞는 용어로 짧은 메시지를 작성하세요

권장

사용자에게 익숙한 용어로 짧은 메시지를 작성하세요.
툴팁은 상호작용할 수 없는 요소이므로 “탭하여 검색”과 같은 동작 유도형 표현은 사용하지 마세요

권장하지 않음

툴팁은 상호작용할 수 없는 요소이므로 “탭하여 검색” 같은 탭을 유도하는 동사로 작성하지 마세요.

툴팁에 오류 메시지를 배치하지 마세요

권장하지 않음

오류 메시지를 툴팁에 넣지 마세요. 오류는 더 큰 강조를 위해 배너에 배치하고, 동작을 표시할 공간도 확보해야 합니다.

툴팁

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

관련 문서

카드 ​

카드는 객체의 시각적 검색 결과 미리보기를 제공합니다. 카드는 가로 스크롤 캐러셀로 배치되며, 이미지에서 각 객체가 차지하는 가로 위치를 기준으로 정렬됩니다.

각 카드는 객체 마커와 짝을 이룹니다. 카드가 스크롤되어 화면에 나타나면 짝을 이루는 객체 마커의 크기가 커집니다. 카드 (또는 객체 마커)를 탭하면 객체의 전체 시각적 검색 결과를 표시하는 모달 바텀 시트가 열립니다.

카드는 시각적 검색 결과의 미리보기를 제공하며, 탭하면 전체 결과가 담긴 모달 바텀 시트가 열립니다. 카드를 가로로 스크롤하면 해당 객체 마커가 강조됩니다.

카드

하나의 주제에 대한 콘텐츠와 링크를 포함합니다.

관련 문서

모달 바텀 시트 ​

모달 바텀 시트에 시각적 검색 결과가 표시됩니다. 레이아웃과 콘텐츠는 앱의 사용 사례, 결과 개수, 결과의 신뢰도에 따라 달라집니다.

모달 바텀 시트에 목록 또는 이미지 그리드를 사용해 여러 시각적 검색 결과를 표시할 수 있습니다
모달 바텀 시트에는 목록 또는 이미지 그리드를 사용해 여러 시각적 검색 결과를 표시할 수 있습니다. 더 많은 결과를 표시하려면 시트를 화면 전체 높이까지 확장할 수 있습니다.

모달 바텀 시트는 단일 결과를 표시하고 콘텐츠에 맞게 레이아웃을 조정할 수 있습니다
모달 바텀 시트는 단일 결과를 표시하고 콘텐츠에 맞게 레이아웃을 조정할 수 있습니다.

바텀 시트

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

관련 문서

경험 ​

이미지를 통한 시각적 객체 검색은 세 단계로 진행됩니다:

  1. 입력: 검색할 이미지 선택
  2. 인식: 객체 감지 및 식별
  3. 결과 전달: 일치하는 객체가 발견되면 결과 표시

입력 ​

시각적 검색은 사용자가 이미지를 선택하면 시작됩니다. 검색에 성공할 가능성을 높이려면 검색에 가장 적합한 이미지 유형을 사용자에게 안내하세요.

권장: 객체가 완전히 보이고 가까운 거리에서 촬영된 선명한 이미지를 추천하는 짧은 설명을 제공하세요

권장

객체가 완전히 보이고 가까운 거리에서 촬영된 선명한 이미지를 추천하는 짧은 설명을 제공하세요.
권장: 사용자가 익숙한 방식으로 사진을 찾을 수 있도록 Android와 iOS의 기본 선택 화면을 사용하세요

권장

사용자가 익숙한 방식으로 사진을 찾을 수 있도록 Android와 iOS의 기본 선택 화면을 사용하세요.

인식 ​

이미지에서 하나 이상의 객체가 감지되면 앱은 다음을 수행해야 합니다:

  • 결과를 기다리고 있음을 사용자에게 알립니다
  • 검색 진행 상황을 표시합니다

ML Kit 객체 감지 및 추적 API가 감지한 객체는 이미지 분류 모델의 기존 이미지 집합과 비교되며, 이 비교를 통해 일치하는 결과를 찾습니다.

사진에서 객체가 감지되었다고 해서 일치하는 결과가 반드시 나오는 것은 아닙니다. 따라서 유효한 검색 결과가 나오기 전에는 객체를 감지된 상태로 표시해서는 안 됩니다.

권장: 비확정형 진행 표시기와 툴팁을 사용해 앱이 일치하는 항목을 찾기 위해 이미지를 분석하고 있음을 사용자에게 알리세요

권장

비확정형 진행 표시기와 툴팁을 사용해 앱이 일치하는 항목을 찾기 위해 이미지를 분석하고 있음을 알리세요. 이 요소들을 선택한 이미지 위에 표시하면 검색이 시작되었음을 사용자에게 보여줄 수 있습니다.
검색 결과가 나올 때까지 감지된 객체 위에 객체 마커를 배치하지 마세요

권장하지 않음

검색 결과가 나올 때까지 감지된 객체 위에 객체 마커를 배치하지 마세요.

인식에 영향을 주는 요인

다음 요인은 객체의 감지 및 식별에 영향을 줄 수 있습니다 (전체를 포괄하는 목록은 아닙니다):

  • 이미지 품질이 낮음
  • 이미지에서 객체의 크기가 작음
  • 객체와 배경 간 대비가 낮음
  • 식별하기 어려운 각도로 객체가 표시됨
  • 검색을 완료하는 데 필요한 네트워크 연결이 끊어짐
권장: 일치하는 객체가 식별되지 않은 경우 배너로 알리세요

권장

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

결과 전달 ​

감지된 객체의 결과는 다음과 같은 방식으로 사용자에게 전달됩니다:

  • 감지된 각 객체 위에 객체 마커를 배치
  • 각 객체의 결과 미리보기를 카드에 표시 (카드 캐러셀의 일부)

앱은 시각적 검색 결과를 표시할 기준이 되는 신뢰도 임계값을 설정해야 합니다. “신뢰도”란 ML 모델이 예측이 얼마나 정확한지 평가한 정도를 의미합니다. 시각적 검색에서 각 결과의 신뢰도 수준은 모델이 해당 결과가 제공된 이미지와 얼마나 잘 일치한다고 판단하는지를 나타냅니다.

이미지 속 하나 이상의 객체에 검색 결과가 있는 경우, 앱은 객체 마커와 각 객체의 결과 미리보기를 보여주는 카드 캐러셀로 감지된 각 객체를 식별해야 합니다. 마커나 카드를 탭하면 해당 객체의 결과를 표시하는 모달 바텀 시트가 열립니다.

권장

모션을 사용해 마커와 카드 사이의 관계를 나타내세요. 스태거 애니메이션은 이미지에서 감지된 각 항목과 그에 해당하는 하단 카드 사이의 연결 관계로 사용자의 주의를 이끕니다.

권장

검색 결과 이미지와 비교해 볼 수 있도록 감지된 객체의 이미지를 함께 표시하세요.

검색 결과 평가 ​

일부 경우에는 시각 검색 결과가 사용자 기대에 미치지 못할 수 있습니다. 예를 들어 다음과 같은 시나리오가 있습니다:

결과 없음

다음과 같은 이유로 검색이 일치 항목 없이 끝날 수 있습니다:

  • 객체가 알려진 객체 집합에 포함되지 않았거나 유사성이 낮음
  • 시각적 검색 모델이 인식하지 못하는 각도에서 감지됨
  • 이미지 품질이 낮아 객체의 핵심 세부 정보를 인식하기 어려움

결과가 없는 경우 배너를 표시하여 이를 설명하고, 검색을 개선하는 방법에 대한 정보를 제공하는 도움말 섹션으로 사용자를 안내합니다.

검색 결과가 없는 경우 배너는 설명 공간과 도움말 콘텐츠로 연결되는 링크를 제공합니다
검색 결과가 없는 경우 배너는 설명 공간과 도움말 콘텐츠로 연결되는 링크를 제공합니다.

품질이 낮은 결과

검색 결과의 신뢰도 점수가 모두 낮다면, 검색 개선 팁과 함께 사용자에게 다시 검색하도록 안내할 수 있습니다.

권장: 모든 결과의 신뢰도가 낮으면 도움말 콘텐츠로 연결하세요

권장

모든 결과의 신뢰도가 낮을 때는 도움말 콘텐츠로 연결하세요.

설명 가능성 + 신뢰

예측, 추천 및 기타 AI 출력 설명하기

관련 문서

테마 설정 ​

Shrine 머티리얼 테마 ​

Shrine 앱의 구매 과정에서는 사용자가 사진을 사용해 상품에 대한 시각적 검색을 수행할 수 있습니다.

결과 로딩 화면은 브랜드의 기본 색상을 반영하기 위해 연한 분홍색 스크림과 다이아몬드 모양 로더를 사용합니다
결과 로딩 화면은 브랜드의 기본 색상과 로고 모양을 반영하기 위해 연한 분홍색 스크림과 다이아몬드 모양 로더를 사용합니다.
Shrine의 색상 및 타이포그래피 스타일이 시각적 검색 결과에 적용됩니다
Shrine의 색상 및 타이포그래피 스타일이 시각적 검색 결과에 적용됩니다.

객체 마커 ​

Shrine의 객체 마커는 브랜드의 모양 스타일 (모서리를 비스듬히 자른 형태)을 반영해 다이아몬드 모양을 사용합니다.

Shrine의 기하학적 로고, 4dp 잘린 모서리가 있는 버튼, 다이아몬드 모양 객체 마커를 보여주는 다이어그램
1. Shrine의 기하학적 로고
2. 4dp 잘린 모서리가 있는 버튼
3. 다이아몬드 모양의 객체 마커

사용자가 결과 카드를 감지된 후보 객체와 짝지을 수 있도록, 일반적으로 캐러셀에서 해당 결과 카드가 선택되면 객체 마커의 크기가 커집니다. Shrine은 객체 마커의 크기 변경 대신 맞춤 색상 및 테두리 스타일로 강조합니다.

객체 마커는 크기 차이를 사용해 어떤 객체가 결과와 관련되어 있는지 사용자에게 알려줄 수 있습니다
1. 객체 마커는 크기 차이를 통해 사용자가 현재 보고 있는 결과 카드에 해당하는 객체를 알려줄 수 있습니다.
2. Shrine의 객체 마커는 색상 및 테두리 스타일 차이로 현재 선택된 객체를 나타냅니다. 마커의 컨테이너 색상은 #FFFFFF에서 Shrine의 On Surface 색상 (#442C2E)으로 바뀌며, 6dp #FFFFFF 테두리가 적용됩니다.

카드 ​

Shrine의 결과 카드는 맞춤 색상, 타이포그래피, 모양 스타일을 사용합니다.

기본적으로 카드는 콘텐츠에 Roboto 글꼴을 사용하고 On Surface 색상으로 #000000을 사용합니다
1. 기본적으로 카드는 콘텐츠에 Roboto 글꼴을 사용하고, On Surface 색상으로 #000000을 사용하며, 4dp 둥근 모서리를 갖습니다.
2. Shrine의 카드는 콘텐츠에 Rubik 글꼴을 사용하고, On Surface 색상으로 Shrine Pink 900 (#442C2E)을 사용하며, 8dp 잘린 모서리를 갖습니다.

Shrine

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

관련 문서

Pager
이전객체 감지: 실시간 카메라
다음바코드 스캔

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

Copyright © 2018-Present Google

https://m2.material.io/design/machine-learning/object-detection-static-image.html

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

Copyright © 2018-Present Google