객체 감지: 정적 이미지
머신러닝을 사용하여 제공된 이미지에서 객체를 감지할 수 있습니다.

사용 방법
사진을 사용한 시각적 검색 (이미지를 입력으로 사용하는 검색 쿼리)으로 실제 세계의 객체를 감지하고 식별할 수 있습니다. 머신러닝 모델 기반의 시각적 검색은 항목에 대한 더 많은 정보를 사용자에게 제공할 수 있습니다. 예를 들어 해당 항목이 어떤 식물 종인지, 구매할 수 있는 상품인지 알 수 있습니다.
ML Kit의 객체 감지 및 추적 API의 “정적” 모드를 사용하면 제공된 이미지에서 최대 5개의 객체를 감지하고, 자체 이미지 분류 모델로 일치하는 결과를 표시할 수 있습니다.
원칙
이 기능의 디자인은 다음 원칙을 기반으로 합니다:
이미지를 선명하게 유지
카메라 UI 컴포넌트를 화면의 상단 및 하단 가장자리에 정렬하면, 이미지 위에 배치된 텍스트와 아이콘의 가독성이 항상 유지됩니다.
실시간 카메라 피드 위에 표시되는 비상호작용 요소는 카메라 화면을 가리지 않도록 반투명하게 표시해야 합니다.

피드백 제공
이미지를 사용한 객체 검색에는 고유한 사용성 요구사항이 따릅니다. 객체가 서로 겹치거나 잘려 있으면 식별하기 어려울 수 있습니다.
오류 상태는 다양한 디자인 수단 (예: 컴포넌트, 모션)으로 전달해야 하며, 사용자가 검색을 개선할 수 있는 방법을 안내하는 설명을 함께 제공해야 합니다.

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

1. 상단 앱 바
2. 객체 마커
3. 툴팁
4. 카드
5. 감지된 이미지
6. 모달 바텀 시트

상단 앱 바
상단 앱 바는 다음 작업을 항상 제공해야 합니다:
- 검색 화면을 종료하는 버튼
- 카메라 플래시를 사용해 밝기를 높이는 토글
- 검색 문제 해결을 위한 도움말 섹션

권장
객체 마커
객체 마커는 감지된 객체의 중심 위에 배치되는 입체적인 원형 표시기입니다. 각 마커는 화면 하단의 카드와 짝을 이루며, 이 카드에는 해당 객체의 결과 미리보기가 표시됩니다. 카드가 스크롤되어 화면에 나타나면 짝을 이루는 객체 마커의 크기가 커집니다.
객체 마커 (또는 결과 카드)를 탭하면 객체의 전체 시각적 검색 결과를 표시하는 모달 바텀 시트가 열립니다.
툴팁
툴팁은 사용자에게 안내 텍스트를 표시합니다. 예를 들어 “검색 중…”과 같은 메시지로 현재 상태를 알리거나, “결과를 보려면 마커나 카드를 탭하세요”와 같은 메시지로 다음 단계를 안내할 수 있습니다.

권장

권장하지 않음

권장하지 않음
카드
카드는 객체의 시각적 검색 결과 미리보기를 제공합니다. 카드는 가로 스크롤 캐러셀로 배치되며, 이미지에서 각 객체가 차지하는 가로 위치를 기준으로 정렬됩니다.
각 카드는 객체 마커와 짝을 이룹니다. 카드가 스크롤되어 화면에 나타나면 짝을 이루는 객체 마커의 크기가 커집니다. 카드 (또는 객체 마커)를 탭하면 객체의 전체 시각적 검색 결과를 표시하는 모달 바텀 시트가 열립니다.
모달 바텀 시트
모달 바텀 시트에 시각적 검색 결과가 표시됩니다. 레이아웃과 콘텐츠는 앱의 사용 사례, 결과 개수, 결과의 신뢰도에 따라 달라집니다.


경험
이미지를 통한 시각적 객체 검색은 세 단계로 진행됩니다:
- 입력: 검색할 이미지 선택
- 인식: 객체 감지 및 식별
- 결과 전달: 일치하는 객체가 발견되면 결과 표시
입력
시각적 검색은 사용자가 이미지를 선택하면 시작됩니다. 검색에 성공할 가능성을 높이려면 검색에 가장 적합한 이미지 유형을 사용자에게 안내하세요.

권장

권장
인식
이미지에서 하나 이상의 객체가 감지되면 앱은 다음을 수행해야 합니다:
- 결과를 기다리고 있음을 사용자에게 알립니다
- 검색 진행 상황을 표시합니다
ML Kit 객체 감지 및 추적 API가 감지한 객체는 이미지 분류 모델의 기존 이미지 집합과 비교되며, 이 비교를 통해 일치하는 결과를 찾습니다.
사진에서 객체가 감지되었다고 해서 일치하는 결과가 반드시 나오는 것은 아닙니다. 따라서 유효한 검색 결과가 나오기 전에는 객체를 감지된 상태로 표시해서는 안 됩니다.

권장

권장하지 않음
인식에 영향을 주는 요인
다음 요인은 객체의 감지 및 식별에 영향을 줄 수 있습니다 (전체를 포괄하는 목록은 아닙니다):
- 이미지 품질이 낮음
- 이미지에서 객체의 크기가 작음
- 객체와 배경 간 대비가 낮음
- 식별하기 어려운 각도로 객체가 표시됨
- 검색을 완료하는 데 필요한 네트워크 연결이 끊어짐

권장
결과 전달
감지된 객체의 결과는 다음과 같은 방식으로 사용자에게 전달됩니다:
- 감지된 각 객체 위에 객체 마커를 배치
- 각 객체의 결과 미리보기를 카드에 표시 (카드 캐러셀의 일부)
앱은 시각적 검색 결과를 표시할 기준이 되는 신뢰도 임계값을 설정해야 합니다. “신뢰도”란 ML 모델이 예측이 얼마나 정확한지 평가한 정도를 의미합니다. 시각적 검색에서 각 결과의 신뢰도 수준은 모델이 해당 결과가 제공된 이미지와 얼마나 잘 일치한다고 판단하는지를 나타냅니다.
이미지 속 하나 이상의 객체에 검색 결과가 있는 경우, 앱은 객체 마커와 각 객체의 결과 미리보기를 보여주는 카드 캐러셀로 감지된 각 객체를 식별해야 합니다. 마커나 카드를 탭하면 해당 객체의 결과를 표시하는 모달 바텀 시트가 열립니다.
권장
권장
검색 결과 평가
일부 경우에는 시각 검색 결과가 사용자 기대에 미치지 못할 수 있습니다. 예를 들어 다음과 같은 시나리오가 있습니다:
결과 없음
다음과 같은 이유로 검색이 일치 항목 없이 끝날 수 있습니다:
- 객체가 알려진 객체 집합에 포함되지 않았거나 유사성이 낮음
- 시각적 검색 모델이 인식하지 못하는 각도에서 감지됨
- 이미지 품질이 낮아 객체의 핵심 세부 정보를 인식하기 어려움
결과가 없는 경우 배너를 표시하여 이를 설명하고, 검색을 개선하는 방법에 대한 정보를 제공하는 도움말 섹션으로 사용자를 안내합니다.

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

권장
테마 설정
Shrine 머티리얼 테마
Shrine 앱의 구매 과정에서는 사용자가 사진을 사용해 상품에 대한 시각적 검색을 수행할 수 있습니다.


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

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

2. Shrine의 객체 마커는 색상 및 테두리 스타일 차이로 현재 선택된 객체를 나타냅니다. 마커의 컨테이너 색상은 #FFFFFF에서 Shrine의 On Surface 색상 (#442C2E)으로 바뀌며, 6dp #FFFFFF 테두리가 적용됩니다.
카드
Shrine의 결과 카드는 맞춤 색상, 타이포그래피, 모양 스타일을 사용합니다.

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