Dunida horumarka Android, ka faa'iidaysiga qalabka maanta waxay ka dhigaysaa faraqa u dhexeeya abka shaqaynaya iyo kan dhabta ah ee goynta. Mid ka mid ah qaybaha ugu badan waa iskaanka ku salaysan ML Kit, oo awood u leh inuu beddelo habka app-ku ula falgalo deegaankiisa iyada oo loo marayo kamaradda. Laga bilaabo akhrinta barcode-yada iyo koodhadhka QR ilaa ogaanshaha walxaha ama aqoonsiga qoraalka iyo wejiyada, suurtogalnimada ayaa ah kuwa aan dhammaad lahayn oo habka saxda ah loo wajaho.
Horumariyayaal badan ayaa ku dheggan aasaaska, iyagoo ku guul daraystay inay si buuxda uga faa'iidaystaan awoodaha ML Kit ee Android. Isku dhafka saxda ah maaha oo kaliya in lagu daro ku-tiirsanaanta iyo tusaalooyinka tijaabada; Furaha ayaa ah in la wanaajiyo waxqabadka, lagu habeeyo halbeeg kasta kiisas gaar ah, oo la fahmo dhammaan xulashooyinka iyo tabaha ay bixiyaan labadaba dukumeentiyada rasmiga ah iyo khibradda xirfadlayaasha kale. Maqaalkan, waxaan u gudbi doonaa, talaabo talaabo iyo qoto dheer, wax kasta oo aad u baahan tahay inaad ogaato si aad uga faa'iidaysato iskaanka ML Kit ee Android, laga bilaabo rakibaadda ilaa goobo horumarsan, oo ay ku jiraan falanqaynta sawirka, maaraynta isku dubaridka, iyo talooyinka lagama maarmaanka u ah in lagu shaqeeyo wakhtiga dhabta ah.
Waa maxay ML Kit iyo sababta uu ugu beddelay iskaanka Android
ML Kit waa SDK ay samaysay Google oo isku xidha tignoolajiyada sirdoonka macmalka ah ee awooda leh ee hawlaha aragga kombayutarka ee aaladaha mobilada. Ma aha oo kaliya in ay u ogolaato in si sahlan loo isticmaalo farsamooyinka barashada mashiinka, laakiin sidoo kale waxay sidaas ku sameysaa qalabka laftiisa, iyada oo aan loo baahnayn isku xirka internetka. Tani waxay ka dhigaysaa qalab la isku halayn karo, degdeg ah, oo faa'iido u leh codsiyada u baahan iskaanka koodka, aqoonsiga wejiga, akhrinta qoraalka, ama aqoonsiga shayga.
Qaab dhismeedka modular ee ML Kit wuxuu siiya dabacsanaan kuwa raadinaya inay ku daraan waxyaabaha daruuriga ah ama u habeeyaan ilaa tafaasiisha ugu yar. Waxaad kala dooran kartaa moodooyinka baakadaysan (ka weyn, la heli karo bilawga) ama moodooyinka si firfircooni leh loo soo dejiyey (kuwaas oo meel ku kaydiya abka laakiin u baahan soo dejin bilow ah). Labadan qaybood ayaa kuu oggolaanaya inaad mudnaanta siiso cabbirka abka ama degdegga isticmaalka iyadoo ku xidhan baahiyaha mashruuca.
Isku-dhafka ML Kit iyo CameraX: Isku-darka Guuleysiga
Haddii aad raadinayso is dhexgal adag oo ka dhexeeya kamarada Android iyo awoodaha ML Kit, CameraX waa xulafadaada ugu fiican. Maktabaddani waxay si weyn u fududaynaysaa gelitaanka qalabka kamaradaha iyo maamulka socodka sawirka, waxayna sidoo kale u oggolaanaysaa in la dul-istaago walxaha is-dhex-galka ah iyo natiijooyinka barashada mashiinka marka loo eego aragtida kamarada.
Iyadoo fasalka ML Kit Analyzer, waxaad ku xidhi kartaa wax-soo-saarka CameraX-ka-baaraha iyo falanqeeyayaasha ML Kit. Falanqeeyuhu wuxuu hirgeliyaa is-dhexgalka Sawirka Falanqaynta.Falanqeeyaha, si hufan u maareynaya xallinta sawirka, isku dubaridka isbeddellada, iyo keenista natiijooyinka, taas oo si weyn u fududaynaysa horumarinta hawlaha sawir-qaadista sare.
Isticmaalka CameraController iyo PreviewView waxay fududaynaysaa soo bandhigida is dhexgalka iyo soo dhawaynta natiijooyinka. Marka la isku darayo ML Kit Analyzer, kaliya waxaad u baahan tahay inaad qeexdo nooca baaraha aad rabto (tusaale, barcode) iyo sida aad u rabto inaad natiijooyinka ku hesho. Intaa waxaa dheer, CameraX waxay daryeeshaa tafaasiisha sida wareejinta sawirka iyo saamiga dhinaceeda, iyada oo iska ilaalinaysa khaladaadka caadiga ah ee horumarinta gacanta.
Ogaanshaha iyo dejinta code-yada: wixii ka baxsan tusaalaha aasaasiga ah
El iskaanka barcode Waa mid ka mid ah kiisaska isticmaalka xiddigaha ee ML Kit ee Android. Waxyaabaha xiisaha leh ayaa ah in API-kiisu uu kuu ogolaanayaa inaad ka fogaato ogaanshaha koodhka QR ee caadiga ah. Laga soo bilaabo GS1, EAN-13, PDF417 ilaa Data Matrix ama Aztec, kala duwanaanshiyaha ayaa ah ugu badnaan, furitaanka albaabka codsiyada saadka, ganacsiga, aqoonsiga alaabta, iyo wax ka badan.
Markaad habaynayso qalabka wax baadha, waxaad ku xaddidi kartaa qaababka aad dhab ahaantii u baahan tahay, taasoo keenta a xawaaraha kordhay iyo isticmaalka khayraadka hoose. Xakamaynta raadinta, habayntu waa mid aad waxtar u leh waxayna si fiican uga jawaabtaa wakhtiga dhabta ah.
Waxa ka mid ah fursadaha la iftiimiyay:
- karti-xirfadeedka suurtagalka ah ee Barcode(): Waxay kuu ogolaanaysaa inaad ogaato dhammaan koodka suurtogalka ah ee ku jira sawirka, xitaa haddii qaar aan weli la go'aamin karin. Tani waxay faa'iido leedahay marka isticmaaluhu u baahan yahay inuu si fiican u soo dhaweeyo ama si fiican u saaro kamarada.
- setZoomSuggetionOptions(): Wuxuu sahlaa autozoom, marka abka si toos ah ayuu u soo jeedin karaa inta ay kamaraduhu tahay inay soo dhaweeyaan si loo kordhiyo akhrinta koodka la ogaaday.
Soo-jeedinta tooska ah waa furaha sifo cusub kaas oo wanaajinaya khibrada isticmaalaha, gaar ahaan xaaladaha meesha fogaanta ama cabbirka koodhku aad u kala duwan yahay. Adiga ayaa fulin kara dib u yeerid si loo hagaajiyo xuduudaha zoom iyadoo la raacayo talooyinka ML Kit detector.
Si sax ah u diyaarinta sawirada gelinta
Mid ka mid ah qodobbada ugu muhiimsan ee waxqabadka ML Kit scanner waa tayada iyo cabbirka sawirada gelinta. Dukumeentiyada rasmiga ah waxay xooga saarayaan pixels ku filan iyo xallinta, maadaama saxnaanta ogaanshaha ay si toos ah ugu xiran tahay matalaadda xogta sawirka.
Tusaale ahaan, koodhadhka EAN-13, baararka iyo meelaha bannaan waa inay ahaadaan ugu yaraan 2 pixels ballaaran; Dhammaan koodka waa in aanu ka yarayn 190 pixels balac. Qaabab aad u adag sida PDF417, cabbirada loo baahan yahay way ka sii weyn yihiin, iyagoo gaaraya ilaa 1156 pixels oo balac ah hal saf.
Diiradda iyo xallinta waa muhiim. Haddii isticmaaluhu uu qaato muuqaal blur ah ama xallin hoose, natiijadu waxay noqon kartaa mid khaldan. Dhaqanka wanaagsan waa in la soo jeediyo sawirro leh xallinta 1280 x 720 ama 1920 x 1080, ilaa iyo inta waxqabadka qalabka uu oggol yahay. Haddii daahitaanka uu yahay arrin, waxaad yarayn kartaa xallinta, laakiin hubi in koodka uu qaato sawirka ugu badan ee suurtogalka ah.
ML Kit's API wuxuu kuu oggolaanayaa inaad u beddesho ilaha sawirka ee aad kamarada ka hesho Sawirka Input. Waxaad ka dhisi kartaa shaygan:
- warbaahin u gaar ah kamarad.Sawirka.
- Bitmap, ByteBuffer ama ByteArray.
- Faylka URI ( faa'iido u leh raritaanka sawirada gallery).
Xaaladda CameraX, qaar badan oo ka mid ah isbeddelladan ayaa si toos ah loo xalliyaa., gaar ahaan marka la eego wareegga sawirka iyo gudbinta waqtiga dhabta ah. Tani waxay culeys badan ka saartaa horumariyaha waxayna hubisaa in sawirka la farsameeyay uu had iyo jeer sax yahay.
Hagaajinta sawirada iyo maaraynta natiijooyinka
Marka sawirka gelinta la diyaariyo, ML Kit detector wuxuu farsameeyaa sawirka oo soo celiyaa liiska natiijooyinka. Barcode-yada, waxaad heli doontaa walxo barcode kaas oo kuu ogolaanaya inaad gasho isku-duwayaasha sawirka, qiimaha la go'aamiyay, nooca xogta (URL, xiriirka, qoraalka, iwm.), iyo xitaa sifooyin dheeri ah haddii la heli karo.
Maareynta natiijooyinkani waa mid dabacsan. Waxaad ku dabooshaa macluumaadka sawirka, la falgeli kartaa isticmaalaha (tusaale, adigoo furaya isku xirka shabakadda haddii ay tahay koodka QR), ama waxaad ku kaydin kartaa qiyamka la ogaaday database-ka. Thanks to isticmaalka dhagaystayaasha, waxaad maarayn kartaa labada guulood iyo khaladaadka ama dhacdooyinka sawirka aan la aqoonsan.
Isku dhafka CameraX, waa lagama maarmaan in si habboon loo xiro mid kasta ImageProxy ka dib markii la farsameeyo, si looga fogaado in xusuusta daadinta iyo ilaalinta dheecaanka falanqaynta-waqtiga dhabta ah.
Hagaajinta falanqaynta waqtiga-dhabta ah
Awoodda buuxda ee Kit ML waa la daah furay marka aad sawirto wakhtiga dhabta ah, tusaale ahaan, qulqulka fiidyaha. Si loo joogteeyo waayo-aragnimo siman, oo aan dib-u-dhac lahayn, waxaa jira dhowr talooyin oo muhiim ah:
- Ha isticmaalin kamarada xalinteeda ugu saraysa ilaa ay daruuri tahay mooyee. Xaalado badan, sawirada 2 megapixel ayaa ka badan ku filan waxayna wanaajiyaan xawaaraha socodsiinta.
- Yaree xallinta haddii xawaaraha uu yahay mudnaanta, laakiin ilaalinta ugu yar ee lagama maarmaanka u ah codaynta saxda ah.
- Daawashada fiidyaha, baarehu waxa uu ku siin karaa natiijooyin kala duwan inta u dhaxaysa fiimyada isku xiga. Waxaa lagu talinayaa in la sugo ugu yaraan dhowr baaritaan oo isku mid ah ka hor inta aan loo tixgelin natiijada mid sax ah.
- Waxay xadidaysaa tirada wicitaanada ee baaraha. Tusaale ahaan, haddii sawirka mar horeba la farsameeyay, iska illow meeraha xiga ilaa aad dhammayso.
- Haddii aad isticmaasho CameraX, hubi inaad dejiso istiraatiijiyadda Falanqaynta Sawirka.STRATEGY_KEEP_ONLY_LATEST in had iyo jeer la keeno sawirkii ugu dambeeyay oo aad ka dhigto mid firfircoon.
- Si loo dahaadho garaafyada sawirka (tusaale sanduuqyada xidhidhiyaha), waxay marka hore habaysaa sawirka ka dibna waxay keenaysaa sawirka iyo dulka labadaba hal baas, iyadoo wanajinaysa cadadka shaqada garaafyada fareemo kasta.
Nooca qaabka sawirka sidoo kale waa muhiim. Haddii aad isticmaasho Camera2, dooro YUV_420_888; API-yadii hore, NV21 waxay dammaanad qaadaysaa iswaafajinta iyo xawaaraha.
Ogaanshaha iyo dabagalka shayga ee ML Kit
Awoodda iskaanka ML Kit kuma koobna barcode-yada: ogaanshaha shayga iyo dabagalka waa sifo kale oo muhiim ah. API-kani wuxuu kuu ogolaanayaa inaad aqoonsato ilaa shan walxood oo muuqaal ah ama jir ah, helitaanka booskooda iyo, marka lagu daro, ku meelaynta aqoonsiga raadraaca gaarka ah mid kasta. Markaad ku shaqeyso fiidyaha waqtiga-dhabta ah, waxaad si sax ah ula socon kartaa dhaqdhaqaaqa shay korka xayndaabyada isdaba jooga ah.
Dejinta ogaanshaha shayada ayaa kuu oggolaanaya inaad:
- Kala dooro qaabka gudbinta (STREAM_MODE), oo loo habeeyay daahitaan hoose iyo dabagal, iyo qaab sawir kaliya (SINGLE_IMAGE_MODE).
- Daar ama dami kala-soocidda walxaha qaybo ballaadhan ( moodada, cuntada, guriga, meelaha, dhirta, shisheeyaha).
- Deji in aad rabto in aad isku mar wada socodsiiso walxo badan ama kan ugu caansan.
Codsiyada waxay u dhexeeyaan aqoonsiga badeecada ee dukaamada, falanqaynta dhirta ama xayawaanka ee abka waxbarashada, ilaa saadka sare iyo nidaamyada caawinta bakhaarka.
Diyaarinta sawirka iyo maaraynta wareejintu waxay raacdaa mabaadi'da lagu sheegay sawirka koodhka, waxaana lagu talinayaa in la isticmaalo Sawirka Input si toos ah looga sameeyay qaabab la taageeray si kor loogu qaado waxqabadka.
Aqoonsiga qoraalka iyo ogaanshaha wejiga
Aqoonsiga qoraalka (OCR) iyo falanqaynta wejiga wakhtiga-dhabta ah waa labada tiir ee kale ee waaweyn ee ML Kit. Qoraalka API waxa uu awood u leeyahay in uu helo baloogyada, xariiqyada, iyo walxaha sawirka ku jira, soo celinta booskooda saxda ah iyo waxa la aqoonsan yahay, xataa xarfo adag ama luuqado kala duwan.
Aqoonsiga wejigu wuxuu ku darayaa awoodda lagu garto jaangooyooyinka, sifooyin gaar ah (indhaha, afka, sanka, iwm.), dejiya ixtimaalka la xidhiidha dhaqdhaqaaqyada (sida dhoola cadeynta ama libiqsiga), oo sawir sawirka si aad u aragto natiijooyinka. Isku-darka fasallada gaarka ah, waxaad tusaale ahaan, ku dabooshaa sanduuqyada ama dhibco ku dul dul-mari kara weji kasta oo la ogaado oo waxaad tusi kartaa macluumaad kala duwan isticmaalaha.
Hirgelinta noocan ah waxay u baahan tahay xoogaa maarayn dheeraad ah marka la eego matalaadda garaafyada., laakiin la dhexgalka CameraX iyo GraphicOverlay waxay ka dhigaysaa habka mid fudud. Soo-saarayaashu waxay si buuxda u habeyn karaan is-dhexgalka waxayna la qabsan karaan natiijooyinka falanqaynta tooska ah ee qaabka muuqaalkooda ee ay rabaan.
Talooyin loogu talagalay waayo-aragnimada isticmaale ee ugu wanaagsan
Guusha muuqaalka sare ee iskaanka kuma xidhna oo kaliya algorithms-yada; sidoo kale waa furaha daryeelka khibrada isticmaalaha. Waa kuwan qaar ka mid ah tilmaamaha waxtarka leh:
- Hubi in walxaha aad rabto inaad ogaato inay caan yihiin oo ay leeyihiin tafaasiil muuqaal ah. Walxaha leh isbarbardhigga hooseeya ama tafaasiisha mugdiga ah waxay u baahan karaan isticmaaluhu inuu u soo dhawaado kamarada.
- Markaad isticmaalayso kala soocida shay, u diyaar garow inaad xakamayso shay aan la garanayn ama aan madmadow lahayn, adoo siinaya jawaab celin cad isticmaalaha.
- Ku dar tilmaamo muuqaal ama qoraal ah interface-ka si aad uga caawiso isticmaaluhu in uu si sax ah u fiirsado, isaga oo iska ilaalinaya niyad-jabka natiijada khaldan awgeed.
- Haddii shay badan la helo, tixgeli ikhtiyaarrada isticmaaluhu si uu u doorto natiijada la xiriirta (tusaale, barnaamijyada waxbarashada ama agabka agabka).
- Xusuusnow inaad la qabsato is-dhexgalkaaga iyo fariimaha khaladka ah ee ku saabsan xaaladaha offline, gaar ahaan haddii aad isticmaasho moodallo si firfircooni leh loo soo dejiyay.
Falanqaynta natiijooyinka iyo tusaalooyin wax ku ool ah
Awoodaha Kit ML Waxay noo ogolaadaan in aan gaadhsiino macluumaad aad qani ah oo habaysan isticmaala dhamaadka. Labadaba ogaanshaha shay iyo iskaanka barcode, waxaad leedahay boosas, qiyam, noocyo, iyo heerarka kalsoonida. Tani waxay suurtogal ka dhigaysaa in la soo bandhigo shaxanka, koobitaanka, ama samaynta ficillada tooska ah (sida furitaanka xiriiriyeyaasha ama kaydinta macluumaadka gadaasha).
Tusaale ahaan, marka laga hadlayo ogaanshaha shay, waxaad u soo bandhigi kartaa isticmaalaha qaybta la aqoonsaday oo leh heerka kalsoonida, aqoonsiga raadraaca si loo barbar dhigo shayga la midka ah ee ku dhex jira xayndaabyo badan, iyo xuduudaha aagga la ogaaday. Marka, abka alaabada, way fududahay in lagu muujiyo shayga ugu muhiimsan oo la raaco qaab qaabaysan si loo farsameeyo falalka ama loo kiciyo iswada.
Is dhexgalka u dhexeeya qaybaha kala duwan ee ML Kit waxay kuu ogolaaneysaa inaad isku darsato hawlahaBal qiyaas in aad ku akhrido barcode shay la ogaaday, oo aad qiimayso oo aad kala saarayso, dhammaan wakhtiga dhabta ah iyo sawirka kamaradda. Noocyada noocaan ah ee is-waafajinta waxa ay ku suurta galayaan oo keliya habaynta horumarsan iyo si dhammaystiran oo dhammaystiran dhammaan fursadaha jira.
Sida wax walba loo casriyeeyo loogana fogaado dhibaatooyinka
Heerka cusboonaysiinta ee maktabadaha ML Kit waa sarreeyaa waxaana muhiim ah in la sii daayo mid kasta oo cusub, maadaama waxqabadka, iswaafajinta, iyo hagaajinta sifada cusub si joogto ah loo soo bandhigo.
Had iyo jeer hubi ku tiirsanaanta faylkaaga dhisaan.gradle oo hubi in heerka SDK ugu yar si sax ah loo qeexay (badanaa API 21 ama ka sareeya). Sidoo kale, dib u eeg hababka bilawga ah, maadaama noocyadii ugu dambeeyay ay hagaajiyeen hababka qaar oo ay soo bandhigeen astaamo cusub, sida soo dejinta tooska ah marka abka la rakibayo.
Talo kale ayaa ah inaad la tashato muunadaha abka iyo agabka waxbarashada ee laga heli karo dukumeentiyada rasmiga ah ee Google iyo meelaha furan labadaba. Khayraadkaas inta badan waxaa ka mid ah Imtixaanada waxqabadka, tusaalooyinka isdhexgalka ee leh is-dhexgal sare, iyo xalinta khaladaadka caadiga ah.
Ilaali iswaafajinta iyo hagaajinta qalabka kala duwan
Mid ka mid ah caqabadaha hor-u-marinta apps-ka Android-ka waa agabka, xallinta, iyo kamaradaha kala duwan ee aad u badan ee laga heli karo suuqa. ML Kit waxaa loo habeeyay qalabyo kala duwan, laakiin had iyo jeer waa fikrad wanaagsan in lagu tijaabiyo abka aalado badan, labadaba kuwa sare iyo kuwa hooseba, si loo hubiyo in farsamaynta iyo tayada muuqaalku ay ku filan yihiin kiisaska oo dhan.
Haddii dhagaystayaashu ay ugu horreyn isticmaalaan aaladaha awoodda yar, mudnaanta sii hufnaanta iyo xawaaraha, u hurida xallinta ama kala duwanaanta shaqeynta haddii loo baahdo si looga fogaado waxyeellaynta khibradda isticmaale.
Waxaan ku soo gabagabeyneynaa dulmar dib u cusbooneysiinaya qodobbada muhiimka ah ee ka faa'ideysiga ugu badan ee ML Kit scanner ee Android: dooro is-dhexgalka ugu wanaagsan ee u dhexeeya CameraX iyo ML Kit, si fiican u diyaari sawiradaada wax gelinta, si habboon u maamul qaababka iyo xallinta sida waafaqsan isticmaalkaaga, oo habayso is-dhexgalkaaga iyo qulqulka shaqada si aad u bixiso khibradda ugu adag uguna horumarsan ee suurtogalka ah labadaba isticmaalayaasha iyo horumarinta.
