扫码头引擎(红外线扫码)

扫码头开发请参考:《 SunmiScanner 开发及使用文档 》

1. 可识别的码

不同型号的扫码头支持的码类型不同,列举部分可支持的码类型,如下表所示:

扫码头编码类型
新大陆二维扫码头code128, uccean128, ean8, ean13, upce, upca, itf, matrix, code39, codabar, code93, isbn, industrial25, standard25, Plessey, code11, msiplessey, pdf417, qr, datamatrix, hanxin
斑马二维扫码头auspostal, Aztec, chinese25, codabar, code11, code128, code39, code93, itf, pdf417, compositeab, composite, uccean128, ean8, ean13, issnean, isbn, upca, upce, upce1, matrix, discrete25, msiplessey, gs1databar, qr, datamatrix, hanxin, maxi, isbt128, korea35, uspostnet, usplanet, ukpostal, japanpostal
新大陆/鹰捷ISSN EAN, MIS-Plessey, Standard 2 of 5, Industrial 2 of 5, ISBN, Code 11, Code 93, Codabar, Code 39, Matrix 2 of 5, Interleaved 2 of 5(ITF), UPC-A, UPC-E, EAN13, EAN8, UCC-EAN128, Code128

用户可根据需求选择可识别的码,具体操作步骤如下:

  1. 在“扫码头设置”中点击“选择可识别码”;
  2. 选择开启或关闭制定识别码,默认开启全部识别码

2. 编码方式

用户可在“输出编码设置”中对输出编码进行设置,可选择 UTF-8,GBK,ISO-8859-1和SHITF-JIS四种编码格式,其中,默认编码格式为 UTF-8 。

3. 提示方式

用户可在“提示方式设置”中对提示方式进行设置,默认打开声音提示和震动提示

4. 输出方式

用户可在“输出方式设置”中对扫码结果的输出方式进行设置,默认选中模拟键盘方式输出、自动补回车、开启广播输出

5. 触发模式

用户可在“触发模式设置”中选择触发模式,默认“短按触发”,扫码成功后扫码头自动熄灭。

注:新大陆扫码头和斑马扫码头在“短按触发,连续扫码”选项表现的现象不同:

  1. 当机器为新大陆扫码头,并且选中了“短按触发,连续扫码”后,扫码头会自动进入连续扫码模式,扫码头会常亮一段时间后熄灭,然后又重新亮起开始扫描,如此循环。
  2. 当机器为斑马扫码头,并且选中了“短按触发,连续扫码”后,机器会自动进入连续扫码模式,扫码头会常亮,除非再次按下扫码键,否则扫码头灯光不会熄灭,且相同的码只会输出一次。

6. Q&A

常见问题:

1. 问:如何对接扫码头?

答:为了方便开发者,商米把扫码头做成了一个免开发的组件。一般用户无需针对扫码头做开发即可获取扫码内容。

2.问:如何获取扫码结果?

答:商米提供了3种数据输出方式 :
1)模拟键盘:会把扫码结果模拟成按键事件,会自动输出到焦点框文本,用户可以通过获取焦点框内容或者监听按键事件来获取扫码结果;
2)直接填充:会把扫码结果拷贝到粘贴版,会自动输出到焦点框文本,相比较与模拟键盘输出方式,直接填充的输出速度更快;
3)广播输出:会把扫码结果作为广播发送,用户可以监听广播来获取扫码结果。

3.问:连续扫码结果不一致?

答:输入法会影响扫码输入结果,已知百度小米版输入法会影响扫码结果输出,可更换谷歌拼音输入法。

4.问:扫码结果比较慢?

答:如果选择了模拟按键输出模式,按键间隔时间会影响输出速度,设置为0为最快速度 (默认0) 。

5.问:需要兼容摄像头扫码和扫码头扫码?

答:L2斑马扫码头与摄像头不可同时开启,用户可以判断机型来区分商米设备和其他设备,在商米设备上使用侧键扫码。

6.问:软件如何触发扫码?

答:可参考L2用户指南 中的aidl接口,扫码服务提供了软触发的接口。

7.问:扫描中文二维码出现乱码怎么解决?

答:解析带中文的二维码需要把输出编码匹配二维码中中文的编码格式,比如二维码的中文“你好”的编号格式为UTF-8,扫码头输出编码也需要设置UTF-8才能正确输出“你好”,否则将会输出乱码。

8.问: 是否支持OCR

新增身份证号码OCR识别功能,暂时仅支持扫码头SS1100,该功能需另外开通,具体可咨询销售或商米对接人May(meijuan@sunmi.com) 。

9. 问: OCR的调用方式和输出方式?

OCR的调用方式和输出方式与扫码的条码输出一致,请参考:《 SunmiScanner 开发及使用文档 》 。

10. 问: OCR功能是否需要授权?

需要授权,在使用中收到提示“ 没有授权文件,请申请licence!”或“ 初始化文字识别SDK失败,请检查授权和配置文件!”,请联系您的销售或商米对接人May(meijuan@sunmi.com)进行授权。申请授权需提供设备的SN号,同时在商米远程发送授权文件时,设备需保持在线 。商米将发送授权文件至设备端 “/sdcard/ SunmiRemoteFiles/ license_ocr.txt”,之后重启APP即可授权通过。若连接无线网进行授权,之后在使用过程中需保持wifi开关为打开状态(无需联网),若连接有线网进行授权,则可直接使用。