wizarPOS 2D Smart POS leiðbeiningar

Innihald fela sig

1 wizarPOS 2D Smart POS

2 Inngangur

3 Bakgrunnur verkefnisins

4 Viðmót og breytulýsing

wizarPOS 2D Smart POS

Inngangur

Tilgangur

Þetta skjal lýsir leiðbeiningum um notkun WizarPOS Scan Service, þar á meðal viðmótslýsingu, færibreytulýsingu og aðferðum við að hringja í þjónustuna.
Notandi
Lesandi þessa skjals er þróunaraðili sem notar WizarPOS skannaþjónustuna.

Bakgrunnur verkefnisins

Yfirview
WizarPOS snjall POS notar sem stendur endurbætt og sérsniðið Android kerfi sem stýrikerfi og hvað varðar skannaaðgerðina kemur Android kerfið ekki með strikamerkjaskönnun/2D strikamerkjaskönnun, heldur notar opna þjónustu, svo sem Zxing/Zbar . Mörg af Android öppunum sem eru notuð á snjallPOS tækjum hafa þegar gert sér grein fyrir mjög fljótlegri skannaaðgerð.
Hins vegar eru mörg önnur forrit þróuð byggð á snjöllum POS, ekki tilbúnum viðskiptaforritum. Og margir af snjöllu POS forriturunum hafa einnig bakgrunn í POS iðnaði, ekki fagmenn Android forritarar. Svo þegar þeir byrja að þróa forrit vilja þeir fá þægilegt skanna API frá WizarPOS, í stað þess að læra Zxing/Zbar sjálfir.
Frá vélbúnaðarpunkti view, skannahlutar sem notaðir eru á snjalla POS, eru ekki endilega venjuleg myndavél, það verður einhver umbreyting. Í sumum tilfellum þarf skannahlutinn að vera sérhæfður vélbúnaður. Þess vegna á bein notkun Zxing /Zbar í raun ekki við fyrir WizarPOS snjalla POS, en þarfnast smá breytingar og sérsníða.
Af ofangreindum ástæðum íhugum við að þróa WizarPOS skannaþjónustu til að auðvelda þriðja aðila þróunaraðilum að þróa forrit með skannaaðgerðum.

Skanna þjónustunotkun
Skannaþjónustan er app og byrjaði með því að nota AIDL. Þriðju aðila forritin sérsníða notendaviðmótið með því að flytja nokkrar breytur.

Viðmót og breytulýsing

Viðmótslýsing
Skanna Strikamerki
Þetta viðmót er samstillt símtalaviðmót.
Þegar forritið hringir í viðmótið opnar skannaþjónustan myndavélina eins og hún er skilgreind af skannafæribreytunni og byrjar skönnunina. Eftir skönnunina er slökkt á myndavélinni og niðurstöðunum skilað strax
ScanResult scanBarcode (ScanParameter færibreyta);

Færibreyta:
ScanParameter
Til baka:
Skannaniðurstaða

byrjar
Þetta viðmót er ósamstillt símtalaviðmót, sem gefur til kynna að samfellda skönnun sé hafin. Þegar forritið kallar á þetta viðmót opnar skannaþjónustan myndavélina eins og hún er skilgreind af skannafæribreytunni og byrjar skönnunina. Eftir hverja skönnun verða niðurstöðurnar skilaðar meðan á svarhringingunni stendur. Eftir hvert svarhringingu er lokið hefst næsta skannaferli. ógilt startScan (ScanParameter færibreyta, IScanCallBack callBack); Færibreyta: ScanParameter, IScanCallBack
Til baka:
Stikamerki fannst í IScanCallBack
Þegar hringt er í startScan() verður að útfæra færibreytuna IScanCallBack. Sá sem hringir getur fengið ScanResult í gegnum þetta viðmót. Þegar hringt er í þetta viðmót er skannaþjónustan í biðstöðu og eftir að símtalinu er svarað verður haldið áfram með næstu skannaaðgerð. Þú getur slökkt á skannaþjónustunni sem er í bið með „stöðva skönnun“.
ógilt strikamerki fannst (ScanResult niðurstaða);

Færibreyta:
Skannaniðurstaða
StopScan
Stöðvaðu samfellda skönnun og slökktu á notendaviðmóti skannaþjónustunnar. Eftir stöðvun geta aðrir hringjendur hringt í startScan, eða scannt Barcode tengi.

Til baka: getScanType(int index)
Sækja tegund skanni.
Stringur getScanType(int index); Færibreyta:
Int 0 eða 1;

Til baka:
Strengur „Skanni“ eða „Myndavél“ eða „Villa“;
Færibreytulýsing
ScanParameter
ScanParameter er færibreytuhlutur, hann skilgreinir færibreyturnar sem skanniþjónustan þarfnast.

aðferð: sett(Strengjalykill, Strengjagildi) (Gildi Ekki hástafaviðkvæmt)

Lykill	Gildi Tegund	Gildi	Lýsing
window_top	int	Sjálfgefið: 0, Svið: >0	Fjarlægðin að toppi skjásins. Áhrif í yfirlagsstillingu. (dp)
glugga_vinstri	int	Sjálfgefið: 0, Svið: >0	Fjarlægðin að skjánum til vinstri. Áhrif í yfirlagsstillingu. (dp)
window_width	int	Sjálfgefin: skjábreidd Svið: >0	Skjástilling. (dp)	breidd.	Áhrif	in	yfirlag
glugga_hæð	int	Sjálfgefin: skjáhæð Svið: >0	Skjáhæð. Áhrif í yfirlagsstillingu. (dp)
enable_scan_section n	Boolean	Sjálfgefið: satt Svið: satt/ósatt	ósatt: allur skjáglugginn er svæðið fyrir skanna, fjarlægðu skannarrammann. satt: sérsniðið svæði skanna, er með skannarramma, hinn hlutinn er hálfgagnsær, skannarramminn er í miðju, getur stillt breidd eða hæð skanni ramma.
skanna_section_width	int	Sjálfgefið: 300 dip Svið: >0	Breidd skannarrammans.
scan_section_high t	int	Sjálfgefið: 300 dip Svið: >0	Hæð skannarrammans.
sýna_skanna_línu	Strengur	Sjálfgefið: hreyfing Svið: Nei/fast/hreyfandi	Birtu rauðu línuna á skannisvæðinu. NEI: Birtist ekki Fast: Í miðju Færa: Færa sig upp og niður
enable_flash_icon	Boolean	W1 上 Sjálfgefið: satt Q1 上 Sjálfgefið: rangt	Hvort á að sýna sveimahnappinn til að stjórna flassinu.
		Svið: satt/ósatt
enable_switch_icon	Boolean	Sjálfgefið: satt Svið: satt/ósatt	Hvort á að sýna sveima hnappur til að skipta um myndavél.
enable_indicator_lig	Boolean	Sjálfgefið: rangt	Hvort sýna eigi vísirinn

ht		Svið: satt/ósatt	ljóshnappur, aðeins studdur á 1. ársfjórðungi.
afkóðasniði	Strengur	Sjálfgefið: BARCODE_ALL Svið: B spilakassa Snið	Afkóða sniðsvið. Sjálfgefið er BARCODE_ALL, sniðin eru aðskilin með ",".
decoder_mode	int	Sjálfgefið: 2 Svið: 0/1/2	Afkóðastilling: 0: ham1 1: háttur 2 2: háttur 3
enable_return_imag e	Boolean	Sjálfgefið: rangt Svið: satt/ósatt	Hvort mynd.	til	skila	the	skannað
myndavélavísir	int	Sjálfgefið: 0 Svið: 0/1/2	0: aðalskanni (fast myndavél). 1: annar skanni (zomm myndavél). 2: myndavél með skjá viðskiptavina.
scan_time_out	langur (ms)	Sjálfgefið: -1 Svið: >0	<=0:skanna að eilífu >0:skannaðu með tímamörkum, þegar tíminn lýkur, villu í skilatíma, kemur aðeins fram í samstilltu viðmóti.
scan_section_bord er_litur	int	Sjálfgefið: Litur.HVÍTUR	Litur skanna ramma, nota Litur.argb
scan_section_corne r_color	int	Sjálfgefið: Color.argb(0xFF, 0x21, 0xDB, 0xD5)	Litur skannahornsins
skanna_section_line_ lit	int	Sjálfgefið: Litur.RAUTUR	Litur skannalínunnar
scan_tip_text	Strengur	Sjálfgefið: sjálfvirkt skanna þegar þú grípur skannaðinn mynd	Ábendingatextinn undir skannarammanum
scan_tip_textStærð	int	Sjálfgefið: 15	Stærð ábendingatexta Eining: sp
scan_tip_textColor	int	Sjálfgefið: Litur.HVÍTUR	Litur ábendingatexta
scan_tip_textMargi n	int	Sjálfgefið: 30	Fjarlægðin milli ábendingatextans og neðst á skjánum Eining: dp
flash_light_state	Boolean	Sjálfgefið: rangt	Upphafsástand flassljóss satt: opnað ósatt: lokað
vísir_ljós_ástand	Boolean	Sjálfgefið: rangt	Upphafsstaða gaumljóss satt: opnað ósatt: lokað

skanna_hamur	Strengur	Sjálfgefin: valmynd	Skannagluggastilling svargluggi: virkni með tilgreindri UI yfirborð: hefur aðeins skannaglugga, án UI titla, UI hnappa, skannagluggann ofan á aðra UI starfsemi
scan_camera_expo viss	int	Sjálfgefið: 0	Lýsingaruppbót myndavélar fyrir aðdráttarmyndavél
scan_time_limit	int	Sjálfgefið: 50	Hámarks afkóðatími
enable_mirror_scan	Boolean	Sjálfgefið: satt	Virkja spegilskönnun Sjálfgefið er satt, opnað
virkja_handfrjálsa	Boolean	Sjálfgefið: satt	Virkja handfrjálsan búnað mun hefja hreyfiskynjun og hreyfilýsingu. Almennt, þegar skönnun stöðugt ætti að gera það kleift. Aðeins fyrir Zebra skanni.
enable_ui_by_zebr a	Boolean	Sjálfgefið: satt	satt: sýna notendaviðmót, ósatt: fela notendaviðmót. Ef þú felur notendaviðmótið mun hraði ræsingarskannisins hraðar. Aðeins fyrir Zebra skanni.
enable_mobile_pho ne_screen_mode	Boolean	Sjálfgefið: rangt	satt: bætir afköst strikamerkjalesturs í farsímum og rafrænum skjám, en gæti aukið afkóðun tíma. Svo ef þú þarft ekki að skanna kóða úr síma, vinsamlegast stilltu hann rangan. Aðeins fyrir Zebra skanni.
enable_upca_count ry	Boolean	Sjálfgefið: satt	satt: eftir UPC_A afkóðun, sýndu landskóða í fyrsta sæti; false: eftir UPC_A afkóðun, fela landskóða fyrst. Aðeins fyrir Zebra skanni.
enable_decoding_ill ummination	Boolean	Sjálfgefið: satt	Að virkja lýsingu leiðir venjulega til betri mynda. Skilvirkni lýsingar minnkar eftir því sem fjarlægð að markmiði eykst. satt: Virkja afkóðun lýsingu, afkóðarinn kveikir á lýsingu á hverri myndatöku aðstoð

afkóðun.

false: Slökktu á afkóðunarlýsingu, afkóðarinn notar ekki afkóðunlýsingu.

Aðeins fyrir Zebra skanni.

enable_motion_illumination

Boolean

Sjálfgefið: rangt

satt: kveikir á hreyfilýsingu í handfrjálsum og sjálfvirkri miðunarstillingu.

false: slekkur á hreyfilýsingu. Þessi færibreyta á aðeins við um handfrjálsa stillingu.

Aðeins fyrir Zebra skanni.

Skannihamur
Í svargluggaham hefur skannarviðmótið teiknað af myndavélaskannaþjónustunni, þriðja appið þarf ekki að huga að notendaviðmótinu.
Í yfirlagsstillingu veitir myndavélaskannaþjónustan aðeins skannagluggann, glugginn mun birtast ofan á þriðja notendaviðmóti forritsins. Þannig að þriðja appið getur teiknað notendaviðmótið af sjálfu sér, eins og titilinn, hnappana. Í þessari stillingu, ef forritið þarf að skipta um myndavél, flassljós, gaumljós, verður það að nota útsendinguna eins og hér að neðan:

Myndavél:
Útsendingaraðgerð: com.wizarpos.scanner.setcamera
Útsendingarlykill: overlay_config
gildi: 0 Föst myndavél; 1 aðdráttarmyndavél; 2 viðskiptavina skjámyndavél

Vasaljós:
Útsendingaraðgerð: com.wizarpos.scanner.setflashlight
Útsendingarlykill: overlay_config
Gildi: satt opnað; falskur lokaður

Gaumljós:
Broadcast Action: com.wizarpos.scanner.setindicator
Útsendingarlykill: overlay_config
Gildi: satt opnað; falskur lokaður

Sample Code: // opnaðu flassljósið

Ásetningur ásetning=nýr ásetning();
intent.setAction(ScanParameter.BROADCAST_SET_FLASHLIGHT);
intent.putExtra(ScanParameter.BROADCAST_VALUE, sendBroadcast(tilgangur);

Zebra skanni

Sebraskönnun krefst eftirfarandi skilyrða:

Er til Zebra myndavél.

Stilltu færibreytuna „camera_index“ á 0- aðalskanni.
Þegar skjárinn er svartur getur myndavélin ekki virkað.

Stilltu færibreytuna „enable_ui_by_zebra“ til að fela sjálfgefið notendaviðmót frá kerfinu.

Skannaniðurstaða

Field	Tegund	Lýsing
niðurstöðukóði	Alþj	>=0: Árangur <0: Bilun Sjá einnig villukóða
texta	Strengur	Textaniðurstaðan, skilar núll þegar villa kom upp, snið textans er UTF-8, ef þörf er á hitt sniðið, vinsamlegast fáðu hráa biðminni og breyta sjálfur.
hrár Buffer	Bæti[]	Hrár biðminni
bitamynd	Bitmap	Skannaða myndin, hún mun skila þegar stillt er á færibreytuna enable_return_image er satt.
strikamerkiFormat	Strengur	strikamerkiSnið, sjá Viðauki

Villukóði

Gildi	Lýsing
1	Árangur
0	Hætta við
2	Skannaviðmótið birtist að fullu
-1	Þjónustan hefur verið upptekin
-2	Get ekki opnað myndavélina
-3	Tímamörk skanna
-4	Ólögleg færibreyta

Notkun

Samþætting skanniþjónustu
Skannaþjónustan notar AIDL, þannig að öpp þriðja aðila verða að innihalda AIDL files(fá frá \source\aidl frá SDK pakkanum með strikamerki) sem veittur er af WizarPOS. Eftirfarandi er lýst aðferðum við að samþætta í Eclipse og Android Studio.
The files innihalda:

Í Eclipse skaltu setja allar files inn í pakkann: com. clouds.scan miðlara. sagði.
Í Android Studio, settu fyrst AIDL files í pakkanum (com. cloud pos. scan server.aidl), pakkinn er í möppu (src—main—aildl), ef pakkinn og möppurnar hafa ekki verið til, vinsamlegast búðu til þær fyrst.

Og settu síðan pakkann (com. cloud pos.scan server.and), tvo í java files pakki í möppunni (src—main–java), ef pakkinn og möppurnar eru ekki til, vinsamlegast búðu til þau fyrst.

hreint verkefni, ef það hefur tekist vel saman í möppu: smíða—myndað—uppspretta—aidl—kemba, þá getur appið hringt í skannaþjónustuna með góðum árangri.

Bindaþjónusta
Við höfum útvegað API fyrir bindingarþjónustu. Settu viðmótið og tækið í hvaða pakka sem er. Fáðu frá \source\aidlControl frá SDK pakkanum með strikamerki.

Notaðu eftirfarandi aðferð til að binda þjónustu:
AidlController.getInstance().startScanService(þetta, þetta);
Innleiða viðmótið IAIDLListener. Fáðu skannaþjónustuna, notaðu þjónustuna til að hringja í aðgerðirnar.