Skip to content
Material Design 2
Main Navigation
v3
v2
v1

Polski

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

Polski

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

Wygląd

Sidebar Navigation

System Material

Wprowadzenie

Studia przypadków Material

O studiach przypadków Material

Basil

Crane

Fortnightly

Owl

Rally

Reply

Shrine

Podstawy Material

Środowisko

Powierzchnie

Wysokość

Światło i cienie

Układ

Zrozumienie układu

Gęstość pikseli

Responsywna siatka układu

Metody odstępów

Zachowanie komponentów

Stosowanie gęstości

Nawigacja

Podstawy nawigacji

Przejścia nawigacyjne

Wyszukiwanie

Kolor

System kolorów

Stosowanie koloru w interfejsie użytkownika

Zastosowanie kolorów

Czytelność tekstu

Ciemny motyw

Typografia

System typograficzny

Zrozumienie typografii

Obsługa języków

Dźwięk

O dźwięku

Zastosowanie dźwięku w interfejsie użytkownika

Atrybuty dźwięku

Choreografia dźwięku

Ikonografia

Ikony produktów

Ikony systemowe

Animowane ikony

Kształt

Informacje o kształcie

Kształt i hierarchia

Kształt jako środek wyrazu

Kształt i ruch

Stosowanie kształtów w interfejsie użytkownika

Ruch

Zrozumienie ruchu

System animacji

Szybkość

Choreografia

Dostosowywanie

Interakcja

Gesty

Zaznaczanie

Stany

Komunikacja

Potwierdzenie i potwierdzenie wykonania

Formaty danych

Wizualizacja danych

Puste stany

Pomoc i opinie

Grafika

Ekran startowy

Onboarding

Stany offline

Pisanie

Uczenie maszynowe

Wzorce uczenia maszynowego

Wykrywanie obiektów: kamera na żywo

Wykrywanie obiektów: obraz statyczny

Skanowanie kodów kreskowych

Wytyczne Material

Material Theming

Omówienie

Wdrażanie własnego motywu

Użyteczność

Dostępność

Dwukierunkowość

Wytyczne dotyczące platform

Paski systemu Android

Odcisk palca w systemie Android

Haptyka w Androidzie

Ikony Androida

Nawigacja między aplikacjami w systemie Android

Powiadomienia na Androidzie

Uprawnienia na Androidzie

Wycinki w Androidzie

Podzielony ekran w Androidzie

Android – przesuń, aby odświeżyć (swipe to refresh)

Pasek narzędzi zaznaczania tekstu w systemie Android

Widżet na Androida

Adaptacja międzyplatformowa

Komponenty

Pasek aplikacji: dolny

Pasek aplikacji: górny

Backdrop

Banery

Dolna nawigacja

Przyciski

Przyciski: pływający przycisk akcji

Karty

Pola wyboru

Chipy

Tabele danych

Selektory daty

Okna dialogowe

Separatory

Listy obrazów

Listy

Menu

Szuflada nawigacyjna

Pasek nawigacyjny

Wskaźniki postępu

Przyciski radiowe

Dolne arkusze

Boczne arkusze

Suwaki

Snackbary

Przełączniki

Zakładki

Pola tekstowe

Selektory godziny

Podpowiedzi (tooltips)

Na tej stronie

Skanowanie kodów kreskowych ​

Dzięki uczeniu maszynowemu aparat urządzenia może na bieżąco odczytywać dane zakodowane w większości standardowych formatów kodów kreskowych.

Obraz nagłówkowy przedstawiający skanowanie kodów kreskowych

Użycie ​

Kody kreskowe to prosty i wygodny sposób przekazywania złożonych lub uporządkowanych danych ze świata rzeczywistego do urządzenia. Interfejs API ML Kit do skanowania kodów kreskowych pozwala aplikacji odczytywać większość standardowych formatów kodów kreskowych bez konieczności przełączania się użytkowników do osobnej aplikacji do odczytu kodów kreskowych.

Skanowanie kodów kreskowych może pomóc użytkownikom w prostych zadaniach związanych z identyfikacją i treścią, takich jak wyszukanie produktu do zakupu, sprawdzenie szczegółów wydarzenia czy wypełnienie formularza.

Te wytyczne projektowe dotyczą skanowania kodów kreskowych z wykorzystaniem podglądu na żywo z aparatu.

Skanowanie kodów kreskowych stanowi dla użytkowników wygodną alternatywę dla ręcznego wyszukiwania informacji o produkcie lub wpisywania danych.

Dokumentacja API ML Kit

Przewodniki dla programistów dotyczące skanowania kodów kreskowych

Powiązany link

Przykład – Android

Aplikacja demonstracyjna ML Kit dla Androida

Powiązany link

Zasady ​

Projektowanie tej funkcji opiera się na następujących zasadach:

Nawigacja za pomocą aparatu urządzenia

Zamiast wpisywać frazę wyszukiwania, jako „pilot” do skanowania kodów kreskowych służy aparat urządzenia.

Aby nauczyć użytkowników, jak skanować kody kreskowe aparatem, zapewnij wprowadzenie oraz stale widoczne instrukcje.

Krótkie animowane wprowadzenie może pokazać, jak prawidłowo ustawić aparat urządzenia, aby zeskanować kod kreskowy.

Czytelność i przejrzystość interfejsu aparatu

Wyrównaj elementy interfejsu aparatu względem górnej i dolnej krawędzi ekranu, tak aby tekst i ikony pozostały czytelne, gdy znajdują się na tle obrazu.

Wszystkie nieinteraktywne elementy wyświetlane przed podglądem na żywo z aparatu powinny być półprzezroczyste, aby w jak najmniejszym stopniu zasłaniały obraz.

Większość elementów jest umieszczona wzdłuż górnej i dolnej krawędzi ekranu, aby zmaksymalizować widoczny obszar
Większość elementów jest umieszczona wzdłuż górnej i dolnej krawędzi ekranu, aby maksymalnie zwiększyć widoczny obszar podglądu z aparatu.

Przekazywanie informacji zwrotnej

Skanowanie kodów kreskowych aparatem wiąże się ze specyficznymi wymaganiami dotyczącymi użytkowania. Jakość obrazu musi być wystarczająca, a użytkownicy powinni wiedzieć, jak rozwiązać problemy z obrazem wynikające z oświetlenia lub zbyt dużej odległości od kodu kreskowego.

Informacje o stanach błędów powinny być przekazywane za pomocą wielu wskazówek wizualnych (takich jak komponenty i animacje) i zawierać wyjaśnienia, jak użytkownicy mogą poprawić wyszukiwanie.

Zarówno ramka kodu kreskowego, jak i etykietka wskazują, że użytkownik musi się zbliżyć, aby „ukończyć” skanowanie kodu kreskowego
Zarówno ramka kodu kreskowego, jak i podpowiedź wskazują, że użytkownik musi się zbliżyć, aby „ukończyć” skanowanie kodu kreskowego.

Komponenty ​

Skanowanie kodów kreskowych za pomocą podglądu na żywo z aparatu wykorzystuje istniejące komponenty Material Design oraz nowe elementy specyficzne dla interakcji z aparatem. Przykłady kodu i pokazy nowych elementów (takich jak ramka kodu kreskowego) znajdziesz w kodzie źródłowym aplikacji demonstracyjnej ML Kit Material Design na Androida.

Kluczowe elementy na poszczególnych etapach procesu skanowania kodów kreskowych
Kluczowe elementy na poszczególnych etapach procesu skanowania kodów kreskowych:
1. Górny pasek aplikacji
2. Ramka kodu kreskowego
3. Etykietka
4. Modalny dolny arkusz
Komponenty

Przykład – Android

Aplikacja demonstracyjna ML Kit dla Androida

Powiązany link

Górny pasek aplikacji ​


Górny pasek aplikacji zapewnia stały dostęp do następujących akcji:

  • Przycisk zamykania trybu wyszukiwania
  • Przełącznik zwiększający jasność (przy użyciu latarki)
  • Sekcja pomocy ułatwiająca rozwiązywanie problemów z wyszukiwaniem
Zalecane: użycie gradientowego przyciemnienia lub jednolitego koloru dla kontenera górnego paska aplikacji, aby jego elementy pozostały czytelne na tle obrazu z aparatu

Zalecane

Użyj gradientowego przyciemnienia lub jednolitego koloru dla kontenera górnego paska aplikacji, aby jego przyciski akcji pozostały czytelne na tle obrazu z aparatu.

Górny pasek aplikacji

Górny pasek aplikacji wyświetla informacje i akcje związane z bieżącym widokiem.

Powiązany artykuł

Ramka kodu kreskowego ​

Ramka kodu kreskowego to obszar na środku ekranu, w którym użytkownik może zeskanować kod kreskowy. Domyślnie ramka ma kształt kwadratu, ale aplikacja powinna dostosować jej rozmiar i proporcje do obsługiwanych typów kodów kreskowych.

Pełni trzy funkcje:

  1. Potwierdzenie: Kształt ramki odpowiada wymiarom pojedynczego kodu kreskowego, dzięki czemu od razu widać, że jednocześnie można zeskanować tylko jeden kod kreskowy.
  2. Czytelność: Chociaż proste formaty kodów kreskowych można odczytać z daleka, złożone formaty (takie jak PDF417) mogą wymagać zbliżenia i obrazu wyższej jakości, aby kod został prawidłowo odczytany. Częściowa krawędź wykrywania nałożona na ramkę kodu kreskowego wskazuje, że użytkownik powinien zbliżyć się, aby zeskanować kod.
  3. Aktywność: Krawędź ramki pulsuje podczas fazy „wykrywania”, wskazując, że aplikacja szuka kodów kreskowych do zeskanowania.
Ramka kodu kreskowego zapewnia animowany przewodnik, który pokazuje: gdzie należy zeskanować kod kreskowy, czy trzeba go powiększyć oraz bieżący stan skanowania.

Stany ramki kodu kreskowego:

1. Na etapie wykrywania animacja pulsowania wskazuje, że aplikacja szuka kodów kreskowych do zeskanowania
2. Wyświetlenie częściowej krawędzi na ramce (wraz z podpowiedzią) wskazuje, że użytkownik musi zbliżyć się do kodu kreskowego
3. Wyszukiwanie jest sygnalizowane przez nieokreślony wskaźnik postępu obejmujący ramkę kodu kreskowego
4. W przypadku błędu ciągły kontur ramki kodu kreskowego zmienia się w kontur kropkowany

Podpowiedź ​

Etykietki wyświetlają użytkownikom tekst informacyjny. Na przykład informują o stanie (wyświetlając komunikat typu „Wyszukiwanie…”) i podpowiadają użytkownikowi następny krok (wyświetlając komunikat typu „Skieruj aparat na kod kreskowy”).

Zalecane: krótkie komunikaty z użyciem terminów odpowiednich dla odbiorców

Zalecane

Pisz krótkie komunikaty, używając terminów odpowiednich dla Twoich odbiorców.
Niezalecane: etykietki z czasownikami oznaczającymi działanie, takimi jak „Naciśnij, aby wyszukać”, ponieważ nie są to elementy interaktywne

Niezalecane

Nie pisz podpowiedzi z czasownikami oznaczającymi działanie, takimi jak „Naciśnij, aby wyszukać”, ponieważ nie są one elementami interaktywnymi.

Niezalecane: umieszczanie komunikatów o błędach w etykietce

Niezalecane

Nie umieszczaj komunikatów o błędach w podpowiedzi. Błędy powinny być wyświetlane w banerze, aby były lepiej widoczne i miały więcej miejsca na przyciski akcji.

Etykietki

Wyświetlają tekst informacyjny, gdy użytkownik najedzie na element kursorem, ustawi na nim fokus lub go dotknie

Powiązany artykuł

Modalny dolny arkusz ​

Modalne dolne arkusze zapewniają dostęp do informacji z kodu kreskowego, gdy użytkownik pozostaje w funkcji skanowania kodów kreskowych. Układ i zawartość dolnego arkusza zależą od typu danych zwróconych przez kod kreskowy, np.:

  • Dane uporządkowane (np. informacje kontaktowe) można wyświetlać w polach tekstowych, które umożliwiają przeglądanie i edycję
  • Informacje z bazy danych powinny być wyświetlane w stylu odpowiednim do przeglądania danej treści. Rodzaje treści będą się różnić. Na przykład treści z mediów społecznościowych będą miały inną strukturę niż treści dotyczące produktu detalicznego.

Wyświetlanie wyników ​

Jeśli użytkownik szybciej lub łatwiej wykona zadanie na innym ekranie w aplikacji, wyświetl informacje z kodu kreskowego na tym ekranie zamiast w modalnym dolnym arkuszu. Zapoznaj się z sekcją Przebieg, aby dowiedzieć się, kiedy i gdzie w aplikacji przekazywać informacje z kodu kreskowego.

Pola tekstowe dobrze nadają się do prezentowania danych uporządkowanych w dolnym arkuszu
Pola tekstowe dobrze nadają się do prezentowania danych uporządkowanych w dolnym arkuszu. Każda etykieta pola i wpisywana w nim wartość mogą przekazywać „klucz” danych i przypisaną mu „wartość”, np. nazwę sieci Wi-Fi.
Układ modalnego dolnego arkusza można dostosować do informacji z kodu kreskowego
Układ modalnego dolnego arkusza można dostosować do informacji z kodu kreskowego, np. profilu użytkownika w mediach społecznościowych.

Dolne arkusze

Powierzchnie zawierające treści uzupełniające, zakotwiczone u dołu ekranu.

Powiązany artykuł

Przebieg ​

Skanowanie kodów kreskowych za pomocą podglądu na żywo z aparatu przebiega w trzech fazach:

  1. Wykrywanie: wyszukiwanie danych wejściowych za pomocą aparatu
  2. Rozpoznawanie: wykrycie kodu kreskowego
  3. Prezentowanie wyników: wyświetlenie wyników skanowania kodu kreskowego w widoku skanera lub na innym ekranie

Wykrywanie ​

„Wykrywanie” oznacza, że aparat szuka kodów kreskowych w podglądzie na żywo. Skanowanie kodów kreskowych rozpoczyna się, gdy użytkownik uruchomi tę funkcję w aplikacji.

Podczas tej fazy aplikacja powinna:

  • Opisywać, jak działa funkcja
  • Informować o działaniach aplikacji
  • Podpowiadać, jak dostosować sposób sterowania aparatem

Zalecane

Wyjaśnij działanie funkcji na jednym ekranie wprowadzenia. Zaleca się użycie animacji, aby pokazać użytkownikowi, jak poruszać urządzeniem.

Zalecane

Poinformuj, że aplikacja szuka kodów kreskowych. Ramka kodu kreskowego pulsuje, wskazując, że aplikacja „skanuje” obraz z aparatu, a podpowiedź zachęca użytkownika do wyśrodkowania kodu kreskowego w ramce.

Pomoc w dostosowaniu ustawień

Warunki otoczenia, np. zbyt jasne lub zbyt ciemne miejsca, mogą utrudniać skanowanie kodu kreskowego.

Sekcja pomocy może pomóc użytkownikom zidentyfikować i rozwiązać problemy z korzystaniem z funkcji
Sekcja pomocy umożliwia użytkownikom identyfikowanie i rozwiązywanie problemów napotkanych podczas korzystania z funkcji. Może zawierać informacje edukacyjne na temat takich kwestii, jak prawidłowy kąt ustawienia aparatu, odległość i warunki oświetleniowe.

Rozpoznawanie ​

Gdy aparat wykryje kod kreskowy, aplikacja powinna:

  1. Wstrzymać podgląd z aparatu i odczytać wartość kodu kreskowego
  2. Wyświetlić wartość od razu, jeśli zawiera ona dane uporządkowane
  3. Wyszukać wartość i wyświetlić postęp wyszukiwania, jeśli wymaga ona sprawdzenia

W tej fazie kod kreskowy jest wykrywany w podglądzie z aparatu i odczytywany przez interfejs API skanowania kodów kreskowych. Podgląd z aparatu zostaje wstrzymany, aby zapobiec zeskanowaniu innego kodu kreskowego.

Kody kreskowe zawierające dane uporządkowane rozpoznawane przez interfejs API (np. współrzędne geograficzne i wydarzenia w kalendarzu) można wyświetlić użytkownikowi od razu. Jeśli kod nie zawiera danych uporządkowanych, jego szczegółowe informacje są pobierane z bazy danych. Aplikacja wyświetla stan ładowania podczas ich pobierania.

Zalecane

Użyj wielu wskazówek wizualnych, aby wskazać, że wykryto obsługiwany kod kreskowy. Krawędź ramki kodu kreskowego zmienia się z przezroczystej na nieprzezroczystą, a podgląd z aparatu zostaje wstrzymany.

Zalecane

Jeśli aplikacja musi sprawdzić wartość kodu kreskowego, wyświetl nieokreślony wskaźnik postępu i komunikat w podpowiedzi, aby wskazać, że trwa oczekiwanie na wyniki.

Rozwiązywanie problemów ​

Wykrycie kodu kreskowego nie gwarantuje, że aplikacja znajdzie wyniki. Mogą wystąpić następujące problemy:

  • Brak odpowiednich wyników: Kod kreskowy, który został pomyślnie zeskanowany, może nie zawierać informacji istotnych dla Twojej aplikacji lub przypadku użycia, np. gdy kod pochodzi z niepowiązanego źródła.
  • Utracone połączenie sieciowe: Jeśli wartość kodu kreskowego jest sprawdzana w bazie danych online, żądanie danych może się nie udać bez dostępu do internetu.
  • Mały rozmiar kodu kreskowego: Chociaż proste formaty kodów kreskowych można odczytać z daleka, złożone formaty (takie jak PDF417) mogą wymagać obrazu z bliższej odległości i o wyższej jakości. Aby wskazać, że użytkownik musi zbliżyć się do kodu kreskowego przed jego zeskanowaniem, ustaw minimalny rozmiar skanowania dla formatów kodów kreskowych akceptowanych przez Twoją aplikację i użyj wielu wskazówek wizualnych (np. w ramce kodu kreskowego i podpowiedzi).

Zalecane: użycie baneru, aby wskazać, że nie zidentyfikowano pasujących obiektów

Zalecane

Użyj baneru, aby wskazać, że nie zidentyfikowano pasujących obiektów. Udostępnij opcje przejścia do dedykowanej sekcji pomocy lub ponowienia próby z innym obrazem.

Zalecane

Ustaw minimalny rozmiar skanowania dla formatów kodów kreskowych akceptowanych przez Twoją aplikację, aby zapewnić ich dokładne zeskanowanie. Poinstruuj użytkownika, aby zbliżył się do kodu kreskowego, aż osiągnie on minimalny rozmiar skanowania.

Błędy i ich elegancka obsługa

Jak obsługiwać błędy ML

Powiązany link

Prezentowanie wyników ​

Wyniki skanowania kodu kreskowego można wyświetlić na kilka sposobów:

  • Bezpośrednio w widoku skanera (w modalnym dolnym arkuszu lub oknie dialogowym)
  • Po zamknięciu funkcji skanowania kodów kreskowych, na ekranie, na którym można wykorzystać informacje z kodu kreskowego

Aby dostosować interfejs do sposobu wykorzystania skanowania kodów kreskowych, zaleca się stosowanie następujących wzorców nawigacji i komponentów:

Przykład przypadku użyciaCzy pozostać w skanerze kodów kreskowych?Miejsce wyświetlania wyników
Przeglądanie produktów w sklepieTakModalny dolny arkusz
Dodanie kontaktuTak, dopóki użytkownik go nie zapiszeModalny dolny arkusz lub pełnoekranowe okno dialogowe
Wypełnienie formularzaNie, powrót do formularzaAutomatyczne wypełnienie odpowiednich pól formularza

Zalecane

Wyświetlaj wyniki skanowania kodu kreskowego na tle podglądu z aparatu, aby użytkownicy mogli skanować kolejne przedmioty bez ponownego otwierania skanera.

Zalecane

Edytowanie i zapisywanie informacji (np. nowego kontaktu) można szybko wykonać w skanerze kodów kreskowych. Prezentuj dane uporządkowane w edytowalnych polach tekstowych, z opcją zapisania i wyjścia ze skanera.

Zalecane

Zeskanowanie kodu kreskowego może stanowić alternatywę dla ręcznego wypełniania pól w formularzu. Po pomyślnym zeskanowaniu użytkownik powinien wrócić do formularza, aby ukończyć zadanie.

Motywy ​

Motyw Material Shrine ​

Skanowanie kodów kreskowych wykorzystuje się w procesie zakupowym aplikacji Shrine.

Przyciemnienie kodu kreskowego i tekst etykietki w aplikacji Shrine wyróżniają się ciemnymi kolorami kontrastującymi z jasnym tłem
Przyciemnienie kodu kreskowego i tekst podpowiedzi w aplikacji Shrine wyróżniają się ciemnymi kolorami kontrastującymi z jasnym tłem.
W wynikach wyszukiwania wizualnego zastosowano kolory marki, typografię i style kształtów Shrine
W wynikach wyszukiwania wizualnego zastosowano kolory marki, typografię i style kształtów Shrine.

Ramka kodu kreskowego ​

Ramka kodu kreskowego w aplikacji Shrine używa koloru Na kolorze podstawowym (On Primary) jako przyciemnienia. Krawędź ramki ma ostre narożniki, które odzwierciedlają geometryczny kształt logo marki.

Domyślna ramka kodu kreskowego używa koloru #000000 jako przyciemnienia, z zaokrągloną krawędzią ramki
1. Domyślna ramka kodu kreskowego używa koloru #000000 jako przyciemnienia, z zaokrągloną krawędzią ramki.
2. Ramka kodu kreskowego Shrine używa koloru Shrine Pink 900 (#442C2E) jako przyciemnienia, z ostrą krawędzią ramki.

Podpowiedź ​

Etykietka w aplikacji Shrine wyróżnia się dzięki niestandardowym kolorom, typografii i rozmieszczeniu.

Etykietki to zazwyczaj mało wyeksponowane komponenty, których szerokość zależy od długości tekstu
1. Etykietki to zazwyczaj mało wyeksponowane komponenty, których szerokość zależy od długości tekstu.
2. Etykietka w aplikacji Shrine używa niestandardowych kolorów i typografii, a jej kontener rozciąga się do krawędzi ekranu.

Shrine

Shrine to marka modowa związana ze stylem życia, która pokazuje, jak Material Design może być stosowany w e-commerce.

Powiązany artykuł

Pager
Poprzednia stronaWykrywanie obiektów: obraz statyczny
Następna stronaOmówienie

Opublikowano na licencji Apache-2.0.

Copyright © 2018-Present Google

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

Opublikowano na licencji Apache-2.0.

Copyright © 2018-Present Google