wizarPOS 2D Smart POS 
تعارف
مقصد
هي دستاويز بيان ڪري ٿو WizarPOS اسڪين سروس استعمال ڪرڻ جي هدايت، بشمول انٽرفيس جي وضاحت، پيراميٽر جي وضاحت، ۽ خدمتن کي ڪال ڪرڻ جا طريقا.
استعمال ڪندڙ
هن دستاويز جو پڙهندڙ هڪ ڊولپر آهي جيڪو استعمال ڪري ٿو WizarPOS اسڪين سروس.
پروجيڪٽ پس منظر
مٿانview
WizarPOS سمارٽ POS هن وقت OS جي طور تي هڪ بهتر ۽ ڪسٽمائيز ٿيل Android سسٽم استعمال ڪري ٿو، ۽ جيئن ته اسڪين فنڪشن لاءِ، Android سسٽم بارڪوڊ اسڪين/2D بارڪوڊ اسڪين فنڪشن سان نٿو اچي، پر اوپن سورس سروسز استعمال ڪري ٿو، جهڙوڪ Zxing/Zbar . ڪيتريون ئي Android ائپس جيڪي استعمال ڪيون وينديون آهن سمارٽ POS ڊوائيسز اڳ ۾ ئي هڪ تمام تيز اسڪين فنڪشن کي محسوس ڪيو آهي.
جڏهن ته، ڪيتريون ئي ٻيون ايپليڪيشنون آهن جيڪي ٺهيل آهن سمارٽ POS جي بنياد تي، نه تيار ڪيل تجارتي ايپليڪيشنون. ۽ ڪيترن ئي سمارٽ POS ڊولپرز وٽ پڻ POS انڊسٽري پس منظر آهي، نه پروفيشنل Android ڊولپرز. تنهن ڪري جڏهن اهي ايپليڪيشنون ٺاهڻ شروع ڪن ٿا، اهي پاڻ کي Zxing/Zbar سکڻ جي بدران WizarPOS پاران هڪ آسان اسڪين API سان مهيا ڪرڻ چاهيندا آهن.
هارڊويئر پوائنٽ کان view، سمارٽ POS تي استعمال ٿيل اسڪين حصا، ضروري نه آھن ته معياري ڪيمرا ھجن، اتي ڪجھ تبديلي ٿيندي. ڪجهه حالتن ۾، اسڪين حصو هڪ خاص هارڊويئر هجڻ جي ضرورت پوندي. تنهن ڪري، Zxing / Zbar جو سڌو استعمال اصل ۾ WizarPOS سمارٽ POS لاءِ قابل اطلاق ناهي، پر ڪجهه ترميم ۽ ڪسٽمائيزيشن جي ضرورت آهي.
مٿين سببن جي ڪري، اسان ترقي ڪرڻ تي غور ڪريون ٿا WizarPOS اسڪين سروسز کي ترقي ڪرڻ لاءِ ٽئين پارٽي ڊولپرز کي اسڪين ڪمن سان گڏ ايپليڪيشنون ٺاهڻ ۾.
اسڪين سروس استعمال
اسڪين سروس هڪ ايپ آهي ۽ AIDL استعمال ڪندي شروع ڪئي وئي آهي. ٽئين پارٽي ائپس انهن جي UI کي ڪسٽمائي ڪن ٿيون ذريعي ڪجهه پيٽرولن جي منتقلي ذريعي.
انٽرفيس ۽ پيٽرول جي وضاحت
- انٽرفيس جي وضاحت
اسڪين بار ڪوڊ
هي انٽرفيس هڪ هم وقت ساز ڪال انٽرفيس آهي.
جڏهن ايپليڪيشن انٽرفيس کي سڏيندي، اسڪين سروس ڪئميرا کي کوليندو آهي جيئن اسڪين پيٽرولر جي وضاحت ڪئي وئي آهي ۽ اسڪين شروع ڪري ٿي. اسڪين کان پوء، ڪئميرا بند ٿي ويو آهي ۽ نتيجا فوري طور تي واپس ايندا
ScanResult scanBarcode(ScanParameter parameter); - پيرا ميٽر:
اسڪين پيراميٽر - واپسي:
اسڪين جا نتيجا - شروع ٿئي ٿو
هي انٽرفيس هڪ هم وقت ساز ڪال انٽرفيس آهي، جيڪو ظاهر ڪري ٿو ته مسلسل اسڪين شروع ٿئي ٿو. جڏهن ايپليڪيشن هن انٽرفيس کي سڏيندي، اسڪين سروس ڪئميرا کي کوليندو آهي جيئن اسڪين پيٽرولر جي وضاحت ڪئي وئي آهي ۽ اسڪين شروع ڪري ٿي. هر اسڪين کان پوء، نتيجن کي ڪال بڪ دوران واپس ڪيو ويندو. هر ڪال بيڪ ٿيڻ کان پوء، ايندڙ اسڪين عمل شروع ٿئي ٿو. void startScan(ScanParameter parameter, IScanCallBack callBack); پيرا ميٽر: اسڪين پيرا ميٽر، IScanCallBack - واپسي:
IScanCallBack ۾ بارڪوڊ مليو
جڏهن ڪال ڪندي startScan()، پيراميٽر IScanCallBack لاڳو ڪيو وڃي. ڪالر حاصل ڪري سگھي ٿو Scan Result هن انٽرفيس ذريعي. جڏهن هن انٽرفيس کي سڏيو ويندو آهي، اسڪين سروس بند حالت ۾ آهي، ۽ ڪال واپس اچڻ کان پوء، ايندڙ اسڪين عمل جاري رکيو ويندو. توھان بند ڪري سگھوٿا اسڪين سروس جيڪا موقوف ۾ آھي ”اسڪين اسٽاپ“ سان.
باطل مليو بارڪوڊ (اسڪين جا نتيجا)؛ - پيرا ميٽر:
اسڪين جا نتيجا - اسٽاپ اسڪين
مسلسل اسڪين کي روڪيو، ۽ اسڪين سروس جي UI کي بند ڪريو. اسٽاپ کان پوء، ٻيا ڪال ڪندڙ ڪال ڪري سگھن ٿا startScan، يا بارڪوڊ انٽرفيس اسڪين. - واپسي: GetScanType (int index)
اسڪينر جو قسم حاصل ڪريو. - اسٽرنگ getScanType (int index)؛ پيرا ميٽر:
انٽ 0 يا 1؛ - واپسي:
اسٽرنگ "اسڪينر" يا "ڪئميرا" يا "غلطي"؛ - پيرا ميٽر جي وضاحت
اسڪين پيراميٽر
ScanParameter ھڪڙو پيٽرولر اعتراض آھي، اھو وضاحت ڪري ٿو پيرا ميٽرز جيڪي اسڪينر سروس جي ضرورت آھي.
طريقو: سيٽ (اسٽرنگ ڪي، اسٽرنگ ويليو) (قدر نه ڪيس حساس)
| چاٻي | قدر
قسم |
قدر | وصف | ||||
| window_top | int | ڊفالٽ: 0،
حد: >0 |
اسڪرين جي چوٽي تائين فاصلو. اوورلي موڊ ۾ اثر.
(ڊي پي) |
||||
| ونڊو_ کاٻي | int | ڊفالٽ: 0،
حد: >0 |
اسڪرين ڏانهن فاصلو کاٻي پاسي. اوورلي موڊ ۾ اثر.
(ڊي پي) |
||||
| window_width | int | ڊفالٽ: اسڪرين جي ويڪر
حد: >0 |
اسڪرين موڊ.
(ڊي پي) |
ويڪر | اثر | in | ڍڪڻ |
| window_height | int | ڊفالٽ: اسڪرين جي اوچائي
حد: >0 |
اسڪرين جي اوچائي. اوورلي موڊ ۾ اثر.
(ڊي پي) |
||||
| enable_scan_sectio n | بولين | ڊفالٽ: سچي حد: سچو/غلط | غلط: سڀ ڊسپلي ونڊو اسڪينر لاء علائقو آهي، اسڪينر فريم کي هٽايو.
صحيح: اسڪينر جي علائقي کي ترتيب ڏيو، ھڪڙو اسڪينر فريم آھي، ٻيو حصو نيم شفاف آھي، اسڪينر فريم مرڪز ۾ آھي، ويڪر يا اوچائي کي ترتيب ڏئي سگھي ٿو اسڪينر فريم. |
||||
| scan_section_width | int | ڊفالٽ: 300dip
حد: >0 |
اسڪينر فريم جي ويڪر. | ||||
| scan_section_heigh
t |
int | ڊفالٽ: 300dip
حد: >0 |
اسڪينر فريم جي اوچائي. | ||||
| ڊسپلي_scan_line | تار | ڊفالٽ: حرڪت واري حد: نه/ مقرر/ حرڪت | اسڪينر واري علائقي ۾ ڳاڙهو لڪير ڏيکاريو.
NO: نه ڏيکاريو مقرر ٿيل: مرڪز ۾ حرڪت: مٿي ۽ ھيٺ ھلڻ |
||||
| enable_flash_icon | بولين | W1 上
ڊفالٽ: صحيح Q1 上 ڊفالٽ: ڪوڙو |
ڇا فليش کي ڪنٽرول ڪرڻ لاءِ هور بٽڻ ڏيکاريو وڃي. | ||||
| حد: سچو/غلط | |||||||
| enable_switch_icon | بولين | ڊفالٽ: سچو
حد: سچو/غلط |
ڇا هوور کي ڏيکارڻ لاء
ڪئميرا سوئچ ڪرڻ جو بٽڻ. |
||||
| enable_indicator_lig | بولين | ڊفالٽ: ڪوڙو | ڇا اشارو ڏيکاريو | ||||
| ht | حد: سچو/غلط | هلڪو بٽڻ، صرف Q1 ۾ سپورٽ. | |||||
| ڊيڪوڊ فارميٽ | تار | ڊفالٽ: BARCODE_ALL | ڊيڪوڊ فارميٽ جي حد. ڊفالٽ آهي BARCODE_ALL، فارميٽ الڳ ٿيل آهن "،" سان. | ||||
| decoder_mode | int | ڊفالٽ: 2 رينج: 0/1/2 | ڊيڪوڊ موڊ: 0: موڊ1
1: موڊ2 2: موڊ3 |
||||
| enable_return_imag
e |
بولين | ڊفالٽ: ڪوڙو
حد: سچو/غلط |
ڇا
تصوير. |
جي طرف | واپسي | جي | اسڪين ٿيل |
| ڪئميرا_انڊيڪس | int | ڊفالٽ: 0 رينج: 0/1/2 | 0: مکيه اسڪينر (مقرر ڪئميرا).
1: سيڪنڊ اسڪينر (زوم ڪئميرا). 2: ڪسٽمر ڊسپلي ڪئميرا. |
||||
| scan_time_out | ڊگهو (ms) | ڊفالٽ: -1
حد: >0 |
<=0: اسڪين هميشه لاءِ
>0: وقت ختم ٿيڻ سان اسڪين، جڏهن وقت ختم، واپسي جي وقت جي غلطي، صرف هم وقت سازي انٽرفيس ۾ اثر انداز. |
||||
| اسڪين_سيڪشن_بورڊ
er_color |
int | ڊفالٽ:
رنگ اڇو |
اسڪين سرحد جو رنگ، استعمال
Color.argb |
||||
| scan_section_corne r_color | int | ڊفالٽ: Color.argb(0xFF, 0x21, 0xDB,
0xD5) |
اسڪين ڪنڊ جو رنگ | ||||
| scan_section_line_
رنگ |
int | ڊفالٽ:
رنگ، ريڊ |
اسڪين لائن جو رنگ | ||||
| scan_tip_text | تار | ڊفالٽ: خودڪار اسڪين جڏهن اسڪين ٿيل قبضو ڪريو
تصوير |
اسڪين بارڊر هيٺ ٽپ جو متن | ||||
| scan_tip_textSize | int | اصلي: 15 | ٽپ جي متن جي ماپ
يونٽ: sp |
||||
| scan_tip_text Color | int | ڊفالٽ:
رنگ اڇو |
ٽپ جي متن جو رنگ | ||||
| scan_tip_textMargi n | int | اصلي: 30 | ٽپ جي متن ۽ اسڪرين جي تري جي وچ ۾ فاصلو
يونٽ: ڊي پي |
||||
| فليش_لائيٽ_رياست | بولين | ڊفالٽ: ڪوڙو | فليش لائيٽ جي شروعاتي حالت صحيح: کوليو ويو
ڪوڙو: بند |
||||
| اشارو_لائيٽ_رياست | بولين | ڊفالٽ: ڪوڙو | اشاري جي شروعاتي حالت سچي روشني: کوليو ويو
ڪوڙو: بند |
||||
| scan_mode | تار | ڊفالٽ: dialog | اسڪينر ونڊو موڊ
ڊائلاگ: مخصوص UI اوورلي سان سرگرمي: صرف اسڪينر ونڊو آهي، بغير UI عنوانن جي، UI بٽڻ، اسڪينر ونڊو ٻين UI سرگرمين جي مٿان |
| scan_camera_expo يقينن | int | ڊفالٽ: 0 | زوم ڪئميرا لاءِ ڪئميرا جي نمائش جو معاوضو |
| scan_time_limit | int | ڊفالٽ: 50 | وڌ ۾ وڌ ڊيڪوڊ وقت |
| enable_mirror_scan | بولين | ڊفالٽ: صحيح | آئيني اسڪين کي فعال ڪريو
ڊفالٽ سچو، کليل |
| فعال_هٿ_آزاد | بولين | ڊفالٽ: صحيح | هينڊ فري کي فعال ڪريو موشن ڳولڻ ۽ حرڪت جي روشني شروع ڪندو. عام طور تي، جڏهن مسلسل اسڪين کي ان کي فعال ڪرڻ گهرجي.
صرف زيبرا اسڪينر لاءِ. |
| enable_ui_by_zebr a | بولين | ڊفالٽ: صحيح | صحيح: ڏيکاريو UI، غلط: لڪايو UI. جيڪڏهن UI لڪايو، شروع اسڪينر جي رفتار تيز ٿي ويندي.
صرف زيبرا اسڪينر لاءِ. |
| enable_mobile_pho ne_screen_mode | بولين | ڊفالٽ: ڪوڙو | صحيح: موبائيل فونز ۽ اليڪٽرانڪ ڊسپلي تي بار ڪوڊ پڙهڻ جي ڪارڪردگي کي بهتر بڻائي ٿو، پر ڊيڪوڊ وڌائي سگھي ٿو
وقت. تنهن ڪري جيڪڏهن فون مان ڪوڊ اسڪين ڪرڻ جي ضرورت ناهي، مهرباني ڪري ان کي غلط سيٽ ڪريو. صرف زيبرا اسڪينر لاءِ. |
| enable_upca_count ry | بولين | ڊفالٽ: صحيح | صحيح: UPC_A ڊيڪوڊنگ کان پوء، ڏيکاريو ملڪ جو ڪوڊ پهرين جڳهه تي؛ غلط: UPC_A ڊيڪوڊنگ کان پوء، پهرين جڳهه تي ملڪ جو ڪوڊ لڪايو.
صرف زيبرا اسڪينر لاءِ. |
| enable_decoding_ill umination | بولين | ڊفالٽ: صحيح | روشني کي چالو ڪرڻ عام طور تي اعلي تصويرن جي نتيجي ۾. روشنيءَ جو اثر گھٽجي ٿو
حدف تائين فاصلو وڌي ٿو. صحيح: ڊيڪوڊنگ روشني کي فعال ڪريو، ڊيڪوڊر روشني کي چالو ڪري ٿو هر تصوير کي پڪڙڻ لاء امداد |
| ڊيڪوڊنگ.
غلط: ڊيڪوڊنگ روشني کي بند ڪريو، ڊيڪوڊر ڊيڪوڊنگ روشني استعمال نٿو ڪري. صرف زيبرا اسڪينر لاءِ. |
|||
| enable_motion_illu mission | بولين | ڊفالٽ: ڪوڙو | صحيح: موشن جي روشنيءَ تي موڙي ٿو هٿ-مفت ۽ آٽو مقصد ٽرگر موڊس ۾.
غلط: حرڪت جي روشني کي بند ڪري ٿو. هي پيٽرول صرف هٿ-مفت موڊ تي لاڳو ٿئي ٿو. صرف زيبرا اسڪينر لاءِ. |
اسڪينر موڊ
ڊائلاگ موڊ ۾، اسڪينر UI ڪئميرا اسڪينر سروس پاران ٺاھيو ويو آھي، ٽئين ايپ کي UI بابت غور ڪرڻ جي ضرورت ناھي.
اوورلي موڊ ۾، ڪئميرا اسڪينر سروس صرف اسڪينر ونڊو مهيا ڪري ٿي، ونڊو ٽئين ايپ UI جي مٿي تي ڏيکاري ويندي. تنهن ڪري ٽيون ايپ UI پاڻ ٺاهي سگھي ٿي، جهڙوڪ عنوان، بٽڻ. هن موڊ ۾، جيڪڏهن ايپ کي ڪئميرا، فليش لائيٽ، اشاري جي روشني کي تبديل ڪرڻ جي ضرورت آهي، اهو لازمي طور تي هيٺ ڏنل براڊڪاسٽ استعمال ڪرڻ گهرجي:
ڪئميرا:
براڊڪاسٽ ايڪشن: com.wizarpos.scanner.setcamera
براڊڪاسٽ ڪيچ: overlay_config
قدر: 0 فڪسڊ ڪيمرا؛ 1 زوم ڪيمرا؛ 2 ڪسٽمر ڊسپلي ڪئميرا
فليش لائيٽ:
براڊڪاسٽ ايڪشن: com.wizarpos.scanner.setflashlight
براڊڪاسٽ ڪيچ: overlay_config
قدر: سچا کليل؛ ڪوڙو بند
روشني اشارو:
براڊڪاسٽ ايڪشن: com.wizarpos.scanner.setindicator
براڊڪاسٽ ڪيچ: overlay_config
قدر: سچا کليل؛ ڪوڙو بند
Sample ڪوڊ: // فليش لائٽ کوليو
ارادو ارادو = نئون ارادو ()؛
intent.setAction(ScanParameter.BROADCAST_SET_FLASHLIGHT)؛
intent.putExtra(ScanParameter.BROADCAST_VALUE، sendBroadcast(intent)؛
زيبرا اسڪينر
زيبرا اسڪين هيٺين شرطن جي ضرورت آهي:
- موجود زيبرا تصويريندڙ.
- 0- مکيه اسڪينر تي "ڪئميرا_انڊيڪس" پيٽرول سيٽ ڪريو.
- جڏهن اسڪرين ڪارو، تصويرر ڪم نٿو ڪري سگهي.
- سسٽم مان ڊفالٽ UI کي لڪائڻ لاءِ "enable_ui_by_zebra" جي پيٽرول کي سيٽ ڪريو.
اسڪين جا نتيجا
| ميدان | قسم | وصف |
| نتيجو ڪوڊ | Int | >=0: ڪاميابي
<0: ناڪامي پڻ ڏسو Error Code |
| متن | تار | متن جو نتيجو، واپسي null جڏهن غلطي ٿي وئي، متن جي شڪل UTF-8 آهي، جيڪڏهن ٻي شڪل جي ضرورت آهي، مهرباني ڪري خام بفر حاصل ڪريو
۽ پنهنجو پاڻ کي تبديل ڪريو. |
| خام بفر | بائيٽ[] | خام بفر |
| bitmap | بِٽ ميپ | اسڪين ٿيل تصوير، اها واپس ايندي جڏهن پيٽرول سيٽ ڪيو وڃي enable_return_image آهي
سچو. |
| بارڪوڊ فارميٽ | تار | barcodeFormat، ڏسو
ضميمو |
غلطي ڪوڊ
| قدر | وصف |
| 1 | ڪاميابي |
| 0 | منسوخ ڪريو |
| 2 | اسڪين UI مڪمل طور تي ڏيکاري ٿو |
| -1 | خدمت تي قبضو ڪيو ويو آهي |
| -2 | ڪئميرا نه کولي سگهي |
| -3 | اسڪين وقت ختم |
| -4 | غير قانوني پيٽرولر |
استعمال
اسڪينر سروس انضمام
اسڪينر سروس AIDL استعمال ڪري ٿي، تنهنڪري ٽئين پارٽي ايپس کي AIDL شامل ڪرڻ گهرجي files ( حاصل ڪريو \ Source \ aidl مان بارڪوڊ SDK پيڪيج) جيڪو WizarPOS پاران مهيا ڪيل آهي. Eclipse ۽ Android Studio ۾ ضم ٿيڻ جا طريقا ھيٺ بيان ڪيا ويا آھن.
جي files شامل آهن:
Eclipse ۾، سڀني کي وجھو files پيڪيج ۾: com. clouds.scan سرور. چيو.
اينڊرائڊ اسٽوڊيو ۾، پھريون ڀيرو اي ڊي ايل لڳايو files پيڪيج ۾ (com. cloud pos. scan server.aidl)، پيڪيج فولڊر ۾ آهي (src-main-aildl)، جيڪڏھن پيڪيج ۽ فولڊر موجود نه آھن، مھرباني ڪري انھن کي پھريون ٺاھيو.
۽ پوءِ، پيڪيج (com. cloud pos.scan server.and) رکو، ٻه جاوا files پيڪيج فولڊر ۾ (src-main-java)، جيڪڏھن پيڪيج ۽ فولڊر موجود نه آھن، مھرباني ڪري انھن کي پھريون ٺاھيو. 
صاف پروجيڪٽ، جيڪڏهن ڪاميابي سان فولڊر ۾ مرتب ڪيو وڃي: build-generated-source-aidl-debug، پوءِ ايپ ڪاميابيءَ سان اسڪينر سروس کي ڪال ڪري سگهي ٿي.
پابند خدمت
اسان مهيا ڪيو آهي API بائنڊ سروس لاءِ. ڪنهن به پيڪيج ۾ انٽرفيس ۽ لاڳو ڪريو. حاصل ڪريو \source\aidlControl مان بارڪوڊ SDK پيڪيج.
- خدمت کي پابند ڪرڻ لاء هيٺين طريقي سان استعمال ڪريو:
AidlController.getInstance().startScanService(هي، هي)؛ - انٽرفيس IAIDLListener کي لاڳو ڪريو. حاصل ڪريو اسڪينر سروس، استعمال ڪريو خدمت ڪال ڪرڻ لاءِ فنڪشن.
ھن فنڪشن کي استعمال ڪريو سروس کي بند ڪرڻ لاء.
مهرباني ڪري پڻ ڏسو Demo پروجيڪٽ تفصيل لاءِ.
ضميمو
بارڪوڊ فارميٽ
Exampاليزي:
دستاويز / وسيلا
 |
wizarPOS 2D Smart POS [pdf] هدايتون 2D Smart POS، 2D، Smart POS |
