Vonalkód-szkennelés
A gépi tanulás segítségével az eszköz élő kamerája a legtöbb szabványos vonalkód-formátumban kódolt adatot képes beolvasni.

Használat
A vonalkódok egyszerű és kényelmes módot kínálnak összetett vagy strukturált adatok átvitelére a valós világból egy eszközre. A ML Kit vonalkód-szkennelési API-ja lehetővé teszi, hogy az alkalmazás a legtöbb szabványos vonalkód-formátumot beolvassa, anélkül hogy a felhasználóknak külön vonalkódolvasó alkalmazásra kellene váltaniuk.
A vonalkódok beolvasása segíthet a felhasználóknak az egyszerű azonosítási és tartalomkezelési feladatokban, például egy megvásárolni kívánt termék megkeresésében, eseményadatok elérésében vagy egy űrlap kitöltésében.
Ezek a tervezési irányelvek az élő kameraképen keresztül történő vonalkód-szkenneléssel foglalkoznak.
Fejlesztői útmutatók a vonalkód-szkenneléshez
Kapcsolódó hivatkozás
Példa – AndroidML Kit bemutatóalkalmazás Androidra
Kapcsolódó hivatkozás
Alapelvek
A funkció tervezése az alábbi alapelveken nyugszik:
Navigálás az eszköz kamerájával
Keresőszó begépelése helyett az eszköz kamerája „távirányítóként” szolgál a vonalkódok beolvasásához.
Hogy a felhasználók megtanulják, hogyan olvassanak be vonalkódot a kamerával, nyújtson bevezetőt és állandóan látható utasításokat.
Tartsa szabadon a kameraképet, és biztosítsa az olvashatóságot
Igazítsa a kamera felhasználói felületének elemeit a képernyő felső és alsó széleihez, biztosítva, hogy a szövegek és ikonok olvashatók maradjanak, ha a kamerakép előtt jelennek meg.
Minden, nem művelethez kapcsolódó elem, amely az élő kamerakép előtt jelenik meg, legyen áttetsző, hogy a lehető legkevésbé takarja ki a kameraképet.

Visszajelzés nyújtása
A kamera vonalkódok beolvasására történő használata különleges követelményekkel jár. A képminőségnek megfelelőnek kell lennie, és a felhasználóknak tudniuk kell, hogyan orvosolhatják a nem megfelelő világításból vagy a vonalkódtól mért túl nagy távolságból eredő képhibákat.
A hibaállapotokat több tervezési eszközzel (például komponensekkel és mozgással) kell jelezni, és magyarázatot kell adniuk arra, hogyan javíthatja a felhasználó a keresését.

Komponensek
Az élő kamerás vonalkód-szkennelés meglévő Material Design komponenseket, valamint a kamerás interakcióhoz kapcsolódó új elemeket használ. Az új elemek (például a vonalkódkeret) kódmintáiért és demóiért tekintse meg az ML Kit Material Design bemutatóalkalmazás Androidra készült verziójának forráskódját.

1. Felső alkalmazássáv
2. Vonalkódkeret
3. Eszköztipp
4. Modális alsó lap

Felső alkalmazássáv
A felső alkalmazássáv állandó hozzáférést biztosít az alábbi műveletekhez:
- Egy gomb a keresési folyamatból való kilépéshez
- Egy kapcsoló a megvilágítás javításához (a kamera vakuja segítségével)
- Egy súgószakasz a beolvasási problémák elhárításához

Ajánlott
Vonalkódkeret
A vonalkódkeret a képernyő közepén található terület, amelyen belül a felhasználó vonalkódot olvashat be. Alapértelmezés szerint a keret négyzet alakú, de méretét és képarányát az alkalmazásnak kell a támogatott vonalkódtípusokhoz igazítania.
Három célt szolgál:
- Megerősítés: A keret alakja egyetlen vonalkód méretéhez igazodik, így egyértelmű, hogy egyszerre csak egy vonalkód olvasható be.
- Olvashatóság: Míg az egyszerű vonalkód-formátumok távolról is beolvashatók, az összetettebb vonalkódformátumok (például a PDF417) pontos beolvasásához közelről készült, jó minőségű képre lehet szükség. A vonalkódkeretre helyezett részleges észlelési szegély jelzi a felhasználónak, hogy a beolvasáshoz közelítenie kell az eszközzel.
- Aktivitás: A keret szegélye az „érzékelés” fázisban lüktet, jelezve, hogy az alkalmazás beolvasható vonalkódokat keres.
1. Az érzékelés lüktető animációt használ, jelezve, hogy az alkalmazás beolvasható vonalkódokat keres
2. Részleges szegély jelenik meg a vonalkódkereten (eszköztippel együtt), jelezve, hogy a felhasználónak közelebb kell tartania az eszközt a vonalkódhoz
3. A keresés határozatlan állapotú folyamatjelzővel jelenik meg, amely átnyúlik a vonalkódkereten
4. Hiba esetén a vonalkódkeret folyamatos vonalstílusa pontozott stílusra vált
Eszköztipp
Az eszköztippek tájékoztató szöveget jelenítenek meg a felhasználóknak. Egyrészt állapotokat jeleznek (olyan üzenettel, mint a „Keresés…”), másrészt a következő lépésre szólítják fel a felhasználót (olyan üzenettel, mint az „Irányítsa a kamerát egy vonalkódra”).

Ajánlott

Kerülendő

Kerülendő
Modális alsó lap
A modális alsó lapok hozzáférést biztosítanak a vonalkód adataihoz, miközben a felhasználó a vonalkód-szkennelési funkcióban marad. Az alsó lap elrendezése és tartalma a vonalkód által visszaadott adattípustól függ, például:
- A strukturált adatok (például névjegyinformációk) szövegmezőkben jeleníthetők meg beolvasáshoz és szerkesztéshez
- Az adatbázisból származó információkat a tartalom megtekintésének megfelelő stílusban kell megjeleníteni. A tartalomtípusok eltérőek lehetnek: például a közösségimédia-tartalom más felépítésű, mint egy kiskereskedelmi termék tartalma.
Eredmények megjelenítése
Ha a felhasználó számára gyorsabb vagy egyszerűbb a feladatot az alkalmazás egy másik képernyőjén elvégezni, akkor a vonalkód adatait modális alsó lap helyett az adott képernyőn jelenítse meg. További információért arról, hogy mikor és hol jelenítse meg az alkalmazás a vonalkód adatait, lásd az Élmény szakaszt.


Élmény
Az élő kamerás vonalkód-szkennelés három fázisból áll:
- Érzékelés: Bevitel keresése a kamerával
- Felismerés: Vonalkód észlelése
- Kommunikáció: A vonalkód eredményeinek megjelenítése beágyazva vagy egy másik képernyőn
Érzékelés
Az „érzékelés” azt jelenti, hogy a kamera vonalkódokat keres az élő kameraképben. A vonalkód-szkennelés akkor kezdődik, amikor a felhasználó megnyitja az alkalmazás vonalkód funkcióját.
Ebben a fázisban az alkalmazásnak:
- El kell magyaráznia, hogyan működik a funkció
- Jeleznie kell az alkalmazás aktuális műveletét
- Útmutatást kell adnia ahhoz, hogyan irányíthatja a felhasználó a kamerát
Ajánlott
Ajánlott
Útmutatás a beállításokhoz
A környezeti körülmények megnehezíthetik a vonalkód beolvasását, például ha a helyszín túl világos vagy túl sötét.

Felismerés
Amikor a kamera vonalkódot észlel, az alkalmazásnak:
- Fel kell függesztenie a kameraképet, és be kell olvasnia a vonalkód értékét
- Azonnal meg kell jelenítenie az értéket, ha az strukturált adat
- Keresést kell végeznie, és jeleznie kell a keresés folyamatát, ha a vonalkód értékét ki kell keresni
Ebben a fázisban a kamera észleli a vonalkódot, és a Vonalkód-szkennelési API beolvassa azt. A kamerakép szünetel, hogy az alkalmazás ne olvasson be másik vonalkódot.
A strukturált adatokat tartalmazó, az API által felismert vonalkódok (például helykoordináták és naptáresemények) azonnal megjeleníthetők a felhasználónak. Ha egy vonalkód adata strukturálatlan, részletes információit egy adatbázisból kéri le a rendszer. Az alkalmazás betöltési állapotot jelenít meg, amíg az információ be nem töltődik.
Ajánlott
Ajánlott
Hibák kezelése
Egy vonalkód észlelése nem garantálja, hogy az alkalmazás találatokat kap. Az alábbi problémák léphetnek fel:
- Nincs releváns találat: Egy sikeresen beolvasott vonalkód nem feltétlenül tartalmaz az alkalmazás vagy a felhasználási eset szempontjából releváns információt, például ha egy nem kapcsolódó forrásból származó vonalkódot olvasnak be.
- Megszakadt hálózati kapcsolat: Ha a vonalkód értékét egy online adatbázisból kell kikeresni, az adatkérés internetkapcsolat hiányában meghiúsulhat.
- Túl kicsi vonalkódméret: Míg az egyszerű vonalkód-formátumok távolról is beolvashatók, az összetettebb vonalkódformátumok (például a PDF417) beolvasásához közelről készült, jó minőségű képre lehet szükség. Annak jelzésére, hogy a felhasználónak a beolvasás előtt közelebb kell tartania az eszközt a vonalkódhoz, állítson be minimális beolvasási méretet az alkalmazás által elfogadott vonalkód-formátumokhoz, és használjon több tervezési jelzést (például a vonalkódkeretben és az eszköztippben).

Ajánlott
Ajánlott
Kommunikáció
A vonalkód beolvasásának eredményei többféle módon jeleníthetők meg:
- A kamerakép felett (modális alsó lapon vagy párbeszédablakon)
- A vonalkód-szkennelési funkcióból való kilépéskor, azon a képernyőn, ahol a vonalkód adatai felhasználhatók
Ahhoz, hogy a felhasználói felületet az adott vonalkódos használati esethez igazítsa, az alábbi navigációs minták és komponensek ajánlottak:
| Példa felhasználási esetre | Marad-e a vonalkódszkennerben? | Az eredmények megjelenítési helye |
|---|---|---|
| Termékek böngészése egy üzletben | Igen | Modális alsó lap |
| Névjegy hozzáadása | Igen, amíg a felhasználó elmenti | Modális alsó lap vagy teljes képernyős párbeszédablak |
| Űrlap kitöltése | Nem, visszatérés az űrlaphoz | Az űrlap releváns mezőinek kitöltése a felhasználó számára |
Ajánlott
Ajánlott
Ajánlott
Témázás
Shrine Material téma
A vonalkód-szkennelést a Shrine alkalmazás vásárlási folyamatában használják.


Vonalkódkeret
A Shrine vonalkódkerete az On Primary színt használja sötétítő rétegként. A keret szegélyének éles sarkai a márka logójának geometriai alakját tükrözik.

2. A Shrine vonalkódkerete Shrine Pink 900 (#442C2E) színt használ sötétítő rétegként, éles keretszegéllyel.
Eszköztipp
A Shrine eszköztippjét egyedi színek, tipográfia és elhelyezés teszik hangsúlyossá.

2. A Shrine eszköztippje egyedi színeket és tipográfiát használ, és a hátterét a képernyő széleiig terjeszti ki.