Skenování čárových kódů
Díky strojovému učení dokáže kamera zařízení v reálném čase číst data zakódovaná ve většině standardních formátů čárových kódů.

Použití
Čárové kódy představují jednoduchý a pohodlný způsob přenosu složitých či strukturovaných dat z fyzického světa do zařízení. API ML Kit pro skenování čárových kódů umožňuje vaší aplikaci číst většinu standardních formátů čárových kódů, aniž by uživatelé museli přecházet do samostatné skenovací aplikace.
Skenování čárových kódů může uživatelům pomoci s jednoduchými úkoly, jako je identifikace obsahu a práce s ním – například vyhledání produktu k nákupu, přístup k podrobnostem o události nebo vyplnění formuláře.
Tyto pokyny pro návrh se týkají skenování čárových kódů pomocí živého obrazu z kamery.
Příručky pro vývojáře ke skenování čárových kódů
Související odkaz
Příklad – AndroidUkázková aplikace ML Kit pro Android
Související odkaz
Principy
Design této funkce vychází z následujících principů:
Navigace pomocí kamery zařízení
Kamera zařízení slouží jako „dálkové ovládání": místo zadávání vyhledávaného výrazu uživatel jednoduše naskenuje čárový kód.
Aby uživatelé věděli, jak pomocí kamery skenovat čárové kódy, zajistěte úvodní seznámení (onboarding) a trvale dostupné pokyny.
Udržujte obraz z kamery nepřekrytý a čitelný
Umístěte komponenty uživatelského rozhraní podél horního a spodního okraje obrazovky a zajistěte, aby text a ikony zobrazené přes obraz z kamery zůstaly čitelné.
Všechny prvky zobrazené přes živý obraz z kamery, s nimiž nelze interagovat, by měly být poloprůhledné, aby co nejméně zakrývaly výhled.

Poskytujte zpětnou vazbu
Skenování čárových kódů pomocí kamery klade na používání specifické požadavky. Kvalita obrazu musí být dostatečná a uživatelé musí vědět, jak napravit problémy s obrazem způsobené osvětlením nebo přílišnou vzdáleností od čárového kódu.
Chybové stavy by měly být vyjádřeny pomocí několika designových vodítek (jako jsou komponenty a pohyb) a měly by obsahovat vysvětlení, jak mohou uživatelé skenování zlepšit.

Komponenty
Skenování čárových kódů pomocí živého obrazu z kamery využívá stávající komponenty Material Design i nové prvky specifické pro interakci s kamerou. Ukázky kódu a dema nových prvků (jako je rámeček čárového kódu) najdete ve zdrojovém kódu ukázkové aplikace ML Kit Material Design pro Android.

1. Horní lišta aplikace
2. Rámeček čárového kódu
3. Tooltip
4. Modální spodní panel

Horní lišta aplikace
Horní lišta aplikace poskytuje trvalý přístup k následujícím akcím:
- Tlačítko pro ukončení funkce skenování
- Přepínač pro zvýšení jasu (pomocí blesku kamery)
- Sekce nápovědy pro řešení problémů se skenováním

Doporučeno
Rámeček čárového kódu
Rámeček čárového kódu je oblast uprostřed obrazovky, v níž může uživatel skenovat čárový kód. Ve výchozím nastavení má rámeček tvar čtverce, ale vaše aplikace by měla jeho velikost a poměr stran upravit podle podporovaných typů čárových kódů.
Plní tři účely:
- Potvrzení: Tvar rámečku odpovídá rozměrům jediného čárového kódu, takže je zřejmé, že najednou lze skenovat pouze jeden čárový kód.
- Čitelnost: Zatímco jednoduché formáty čárových kódů lze přečíst i z dálky, složitější formáty (jako PDF417) mohou pro přesné přečtení vyžadovat bližší záběr a vyšší kvalitu obrazu. Zobrazením částečného detekčního okraje přes rámeček čárového kódu uživatelské rozhraní naznačuje, že se má uživatel s kamerou ke čárovému kódu přiblížit.
- Aktivita: Okraj rámečku během fáze „snímání“ pulzuje, čímž naznačuje, že aplikace hledá čárové kódy k naskenování.
1. Snímání využívá pulzující animaci, která naznačuje, že aplikace hledá čárové kódy k naskenování
2. Částečný okraj zobrazený přes rámeček (spolu s tooltipem) naznačuje, že se uživatel musí ke čárovému kódu přiblížit
3. Stav hledání je vyjádřen nekonečným ukazatelem průběhu zobrazeným přes rámeček čárového kódu
4. Při chybě se souvislý obrys rámečku čárového kódu změní na tečkovaný
Tooltip
Tooltipy (bubliny s nápovědou) zobrazují uživatelům informativní text. Můžou například zobrazit aktuální stav (zprávou typu „Hledání…“) i vyzvat uživatele k dalšímu kroku (zprávou typu „Namiřte kameru na čárový kód“).

Doporučeno

Nedoporučeno

Nedoporučeno
Modální spodní panel
Modální spodní panely poskytují přístup k informacím z čárového kódu, zatímco uživatel zůstává ve funkci skenování čárových kódů. Rozvržení a obsah spodního panelu závisí na typu dat obsažených v čárovém kódu, například:
- Strukturovaná data (například kontaktní údaje) lze zobrazit v textových polích pro prohlížení a úpravy
- Informace z databáze by měly být zobrazeny ve stylu vhodném pro prohlížení daného obsahu. Typy obsahu se liší – obsah ze sociálních sítí bude mít například jinou strukturu než obsah maloobchodního produktu.
Zobrazení výsledků
Pokud je pro uživatele rychlejší nebo jednodušší dokončit úkol na jiné obrazovce aplikace, zobrazte informace z čárového kódu na této obrazovce namísto modálního spodního panelu. Další informace o tom, kdy a kde v aplikaci informace z čárového kódu zobrazit, najdete v části Uživatelský zážitek.


Uživatelský zážitek
Skenování čárových kódů pomocí živého obrazu z kamery probíhá ve třech fázích:
- Snímání: Použít kameru k vyhledání vstupních dat
- Rozpoznání: Detekovat čárový kód
- Komunikace: Zobrazit výsledky čárového kódu přímo ve funkci skenování nebo na jiné obrazovce
Snímání
„Snímání“ označuje fázi, ve které kamera hledá čárové kódy v živém obrazu. Skenování začíná, když uživatel v aplikaci otevře funkci skenování čárových kódů.
Během této fáze by aplikace měla:
- Popsat, jak funkce funguje
- Sdělit uživateli, co aplikace dělá
- Poradit uživateli, jak upravit nastavení kamery
Doporučeno
Doporučeno
Návod k úpravám
Podmínky prostředí mohou skenování čárového kódu ztížit – například příliš osvětlená nebo příliš tmavá místa.

Rozpoznání
Když kamera detekuje čárový kód, aplikace by měla:
- Pozastavit obraz z kamery a přečíst hodnotu čárového kódu
- Pokud jde o strukturovaná data, zobrazit hodnotu okamžitě
- Pokud je třeba hodnotu čárového kódu dohledat, spustit vyhledávání a zobrazit jeho průběh
V této fázi je čárový kód v obrazu kamery detekován a přečten pomocí API pro skenování čárových kódů. Obraz z kamery se pozastaví, aby aplikace omylem neskenovala jiný čárový kód.
Čárové kódy obsahující strukturovaná data rozpoznaná rozhraním API (jako jsou souřadnice polohy a události v kalendáři) lze uživateli zobrazit okamžitě. Pokud data z čárového kódu nejsou strukturovaná, podrobné informace se načítají z databáze. Dokud aplikace tyto informace vyhledává, zobrazuje indikátor načítání.
Doporučeno
Doporučeno
Náprava problémů
Detekce čárového kódu nezaručuje, že aplikace najde výsledky. Mohou nastat následující problémy:
- Žádné relevantní výsledky: Čárový kód, který lze úspěšně naskenovat, nemusí obsahovat informace relevantní pro vaši aplikaci nebo případ užití – například čárový kód z nesouvisejícího zdroje.
- Ztráta připojení k síti: Pokud se hodnota čárového kódu dohledává v online databázi, požadavek na data může bez připojení k internetu selhat.
- Malá velikost čárového kódu: Zatímco jednoduché formáty čárových kódů lze přečíst i z dálky, složitější formáty (jako PDF417) mohou pro přečtení vyžadovat bližší záběr a vyšší kvalitu obrazu. Chcete-li naznačit, že se uživatel musí před skenováním ke čárovému kódu přiblížit, nastavte minimální snímací velikost pro formáty čárových kódů podporované vaší aplikací a použijte více designových vodítek (například rámeček čárového kódu a tooltip).

Doporučeno
Doporučeno
Komunikace
Výsledky skenování čárového kódu lze zobrazit několika způsoby:
- Přes obraz z kamery (v modálním spodním panelu nebo dialogu)
- Po ukončení funkce skenování čárových kódů na obrazovce, kde lze s informacemi z čárového kódu pracovat
Chcete-li uživatelské rozhraní přizpůsobit vašemu případu užití čárových kódů, doporučují se tyto navigační vzory a komponenty:
| Příklad případu užití | Zůstat ve skeneru čárových kódů? | Místo zobrazení výsledků |
|---|---|---|
| Procházení produktů v obchodě | Ano | Modální spodní panel |
| Přidání kontaktu | Ano, dokud jej uživatel neuloží | Modální spodní panel nebo celoobrazovkový dialog |
| Vyplnění formuláře | Ne, návrat do formuláře | Vyplnění příslušných polí formuláře za uživatele |
Doporučeno
Doporučeno
Doporučeno
Motivy
Motiv Material Shrine
Skenování čárových kódů se používá v nákupním procesu aplikace Shrine.


Rámeček čárového kódu
Rámeček čárového kódu v aplikaci Shrine používá pro svůj scrim barvu On Primary. Okraj rámečku má ostré rohy, které odrážejí geometrický tvar loga značky.

2. Rámeček čárového kódu v aplikaci Shrine používá pro barvu scrimu Shrine Pink 900 (#442C2E) a ostrý okraj rámečku.
Tooltip
Tooltip v aplikaci Shrine je zvýrazněn použitím vlastních barev, typografie a umístění.

2. Tooltip v aplikaci Shrine používá vlastní barvy a typografii a jeho kontejner sahá až k okrajům obrazovky.