新大陆 Android 无线数据终端软件软件开发指南 V1.4 版本记录 版本号 版本描述 发布日期 V1.0 初始版本 2016-10-11 V1.0.1 扫描超时默认改成 3 秒 2016-11-14 V1.0.2 获取扫描结果项中添加码制类型 2016-11-24 V1.0.3 删除 PSAM 2016-11-30 V1.0.4 增加停止扫码的接口 2017-03-31 V1.0.5 删除备用按键章节 2017-08-02 V1.0.6 恢复选用按键章节, 并修改其内容 2017-08-03 V1.1 扩展广播设置扫描参数的接口 2018-6-13 V1.2 增加码制类型参照表 2018-6-19 V1.3 增加码制数据设置接口 2018-7-14 V1.4 调整文档格式及说明 2018-12-20 Date:2018/12/20 Page : 1 / 11
一 开发环境... 3 二 获取设备产品识别属性... 3 三 扫描服务... 3 1) 开启扫描... 3 2) 获取扫描结果... 3 3) 停止扫描... 4 4) 修改扫描设置默认值... 5 四 备用按键... 6 五 其他接口... 7 1) 状态栏下拉... 7 1) 按 Home 键返回桌面... 7 2) 设置系统时间... 7 附件... 9 码制类型对照表... 9 Date:2018/12/20 Page : 2 / 11
本手册适用于新大陆无线数据终端 (Android 系统 ) 一 开发环境 设备的二次开发接口采用了 android 的标准广播方式通信, 不需要额外的 SDK, 应用程序开发环境与原 生 Android 系统的应用开发环境兼容 二 获取设备产品识别属性 可通过系统属性 :android.os.build.model 获取设备产品型号, 应用程序可根据该变量自适应不同产商 设备, 例如 MT65 MT90 NFT10 等 三 扫描服务 1) 启动扫描 注 : 当使用物理扫描键来触发扫描时, 系统底层会自行监听扫描按键并启动扫描, 应用程序无需发送此 广播, 直接跳过这步操作 发送一个广播以启动扫描 广播名 Action:nlscan.action.SCANNER_TRIG Extra 扫描超时参数 :SCAN_TIMEOUT ( 单位为秒, 值为 int 类型, 且不超过 9 秒, 默认 3 秒 ) Extra 扫码类型参数 :SCAN_TYPE 举例 1: 举例 2: ( 单码 双码类型, 值为 1: 单码, 值为 2: 双码, 默认单码 ;) 注 : 暂不支持双码 Intent intent = new Intent ("nlscan.action.scanner_trig"); mcontext.sendbroadcast(intent); Intent intent = new Intent ("nlscan.action.scanner_trig"); intent.putextra("scan_timeout", 4);// 单位为秒, 值为 int 类型, 且不超过 9 秒 intent.putextra("scan_type ", 2);// 扫码类型 : 双码 mcontext.sendbroadcast(intent); 说明 : 如果当前已经启动了扫描, 此时如果系统又收到该广播, 则表示取消当前正在进行的扫描事务 2) 获取扫描结果 直接填充模式 : 当设置该输出模式时, 结果会自动填充到焦点状态的输入框 模拟键输出模式 : 当设置该输出模式时, 结果会转换按键键值输出到焦点状态的界面 API 输出模式 : 当设置该输出模式时, 需要注册广播监听来获取结果 以上三种输出方式可通过扫描设置工具直接设置, 也可通过第 4 小点中提到的方法使用广播进行设 置 广播名 Action:nlscan.action.SCANNER_RESULT Extra 扫描结果 1 参数 :SCAN_BARCODE1 Date:2018/12/20 Page : 3 / 11
数据类型为 :String Extra 扫描结果 2 参数 :SCAN_BARCODE2 数据类型为 :String Extra 码制类型 :SCAN_BARCODE_TYPE 数据类型为 :int (-1: 表示未知类型 ) Extra 扫码状态参数 :SCAN_STATE ( 该参数有两个值 :fail 或 ok.) 数据类型为 :String 举例 1: 注册广播 : mfilter= newintentfilter("nlscan.action.scanner_result"); mcontext.registerreceiver(mreceiver, mfilter); 注销获取扫描结果的广播 mcontext.unregisterreceiver(mreceiver); 获取结果值 : mreceiver= newbroadcastreceiver() { @Override publicvoidonreceive(context context, Intent intent) { final String scanresult_1=intent.getstringextra("scan_barcode1"); final String scanresult_2=intent.getstringextra("scan_barcode2"); final int barcodetype = intent.getintextra("scan_barcode_type", -1); // -1:unknown final String scanstatus=intent.getstringextra("scan_state"); if("ok".equals(scanstatus)){ // 成功 else{ // 失败如超时等 ; 3) 停止扫描 注 : 当使用物理扫描键来触发扫描时, 系统底层会自行监听扫描按键并按照设定好的扫描模式来停止扫 描, 应用程序无需发送此广播, 直接跳过这步操作 即使用物理扫描键启动读码, 只需通过广播获取扫 描结果, 无需在应用程序中处理启动 停止扫描的操作 发送一个广播, 可以停止正在进行的扫描操作 广播名 Action:nlscan.action.STOP_SCAN 例 : Intent stopintent = new Intent( nlscan.action.stop_scan ); mcontext.sendbroadcast(stopintent); Date:2018/12/20 Page : 4 / 11
4) 修改扫描设置默认值 修改通用配置 应用程序可以通过发送广播以配置系统扫描头使能及数据输出模式 其广播名为 : ACTION_BAR_SCANCFG, 该广播最多可带 3 个参数, 应用程序可根据需要一次修改以下一个或多个参数, 参数定义如下, 标 * 为默认值 : 参数名 参数类型 备注 EXTRA_SCAN_POWER 值 = 0 表示禁用扫描功能 = 1 表示打开扫描功能 * 说明 : 当扫描头刚打开的时候需要初始化扫描头, 需要一定时间, 此时将忽略相关扫描请求 EXTRA_TRIG_MODE 值 = 0 配置扫描头为普通触发模式 = 1 配置扫描头为连续扫描模式 = 2 配置扫描头为超时扫描模式 * EXTRA_SCAN_MODE 值 = 1 : 直接填充模式 * = 2 : 虚拟按键模式 = 3 : 广播输出模式 EXTRA_SCAN_AUTOENT 值 = 0 关闭自动换行 * = 1 允许自动换行 EXTRA_SCAN_NOTY_SND 值 = 0 关闭声音提示 = 1 打开声音提示 * EXTRA_SCAN_NOTY_VIB 值 = 0 关闭振动提示 * = 1 打开振动提示 EXTRA_SCAN_NOTY_LED 值 = 0 关闭指示灯提示 = 1 打开指示灯提示 * SCAN_TIMEOUT LONG 一次扫描超时时间 ( 毫秒 ) 如 3 秒 :3000 SCAN_ERVAL TRIGGER_MODE_MAIN TRIGGER_MODE_LEFT TRIGGER_MODE_RIGHT TRIGGER_MODE_BLACK NON_REPEAT_TIMEOUT SCAN_PREFIX_ENABLE LONG LONG 连续扫描时, 两次扫描的间隔时间 ( 毫秒 ), 值 >=50, 默认 :50( 毫秒 ) 值 = 0 主扫描键禁止扫描 = 1 主扫描键允许扫描 * 值 = 0 左侧扫描键禁止扫描 = 1 左侧扫描键允许扫描 * 值 = 0 右侧扫描键禁止扫描 = 1 右侧扫描键允许扫描 * 值 = 0 背面扫描键禁止扫描 = 1 背面扫描键允许扫描 * ( 前提支持背扫描键功能 ) 不发送重复条码数据的时间间隔 ( 毫秒 ), 如 2 秒 :2000 值 = 0 前缀禁用 = 1 前缀使能 * Date:2018/12/20 Page : 5 / 11
SCAN_SUFFIX_ENABLE 值 = 0 后缀禁用 = 1 后缀使能 * SCAN_PREFIX STRING 前缀值,16 进制表示, 如 0x61, 则传入 : 61 默认 : 空 SCAN_SUFFIX STRING 后缀值,16 进制表示, 如 0x61, 则传入 : 61 默认 : 空 SCAN_ENCODE 编码格式 : 值 = 1 UTF-8 = 2 GBK * = 3 ISO_8859_1 OUTPUT_RECOVERABLE BOOLEAN 值 = true 使用覆盖输出 = false 禁止覆盖输出 * 举例 1: 禁用扫描功能 Intent intent = new Intent ("ACTION_BAR_SCANCFG"); intent.putextra("extra_scan_power", 0); mcontext.sendbroadcast(intent); 举例 2: 设置扫描为 广播输出模式, 同时输出 自动换行 Intent intent = new Intent ("ACTION_BAR_SCANCFG"); intent.putextra("extra_scan_mode", 3); intent.putextra("extra_scan_autoent", 1); mcontext.sendbroadcast(intent); 修改码制配置应用程序可以通过发送广播以配置扫描头码制与相关参数使能 ( 参数值详情随不同的识读头而不同, 参考识读头的参数值手册 ) 其广播名为 :ACTION_BARCODE_CFG 参数名参数类型备注 CODE_ID STRING 码制 ID PROPERTY STRING 码制属性 ID VALUE STRING 码制属性的设置值举例 1: 打开 EAN-8 码制的 发送校验 功能 Intent intent = new Intent ("ACTION_BARCODE_CFG"); intent.putextra("code_id", EAN8 ); intent.putextra("property", TrsmtChkChar ); intent.putextra("value", 1 );//1 开, 0 关 mcontext.sendbroadcast(intent); 四 备用按键 MT65 型号备用按键 :F1 F2 F3 F4 MT90 型号备用按键 :F6 Date:2018/12/20 Page : 6 / 11
应用程序可以根据用户需要, 自行定义备用按键的功能 举例 : 处理备用按键按下事件 public boolean onkeydown(int keycode, KeyEvent event) { switch (keycode) { case KeyEvent.KEYCODE_F6: showinfo("f6 键按下 \n"); break; return super. onkeydown(keycode,event); 举例 : 处理备用按键弹起事件 public boolean onkeyup(int keycode, KeyEvent event) { switch (keycode) { case KeyEvent.KEYCODE_F6: showinfo("f6 键放开 \n"); break; return super.onkeydown(keycode, event); 五 其他接口 1) 状态栏下拉 设置状态栏是否可以下拉的 api 接口, 应用层通过向系统发送广播, 其中广播的内容为 :ENABLE 为 true 时, 状态栏可以下拉,ENABLE 为 false 时, 状态栏禁止下拉 举例 : 状态栏禁止下拉 Intent intent = new Intent("nlscan.action.STATUSBAR_SWITCH_STATE"); intent.putextra("enable", false); context.sendbroadcast(intent); 1) 按 Home 键返回返回桌面 设置 HOME 键短按是否可以回到桌面, 应用层通过向系统发送广播, 其中广播的 extra 内容为 :ENABLE 为 true 时, 按 HOME 键可以回到桌面,ENABLE 为 false 时, 按 HOME 键禁止回到桌面 举例 : 按 HOME 键禁止回到桌面 Intent intent = new Intent("nlscan.action.HOMEKEY_SWITCH_STATE"); intent.putextra("enable", false); context.sendbroadcast(intent); 2) 设置系统时间 Date:2018/12/20 Page : 7 / 11
根据时间的毫秒数来设置系统时间, 应用层通过向系统发送广播, 其中广播的 extra 的参数名为 TIME_MS, 参数类型为 string, 表示系统时间毫秒数 举例 : public long gettimemillis(){ Calendar c = Calendar.getInstance(); c.set(2016, 0, 1, 0,0,0); return c.gettimeinmillis(); Intent it = new Intent("nlscan.action.SET_TIME"); long mills = gettimemillis(); it.putextra("time_ms", String.valueOf(mills)); mcontext.sendbroadcast(it); Date:2018/12/20 Page : 8 / 11
附件 码制类型对照表 Code name 0 ZASETUP 1 SETUP128 2 CODE128 3 UCCEAN128 4 AIM128 5 GS1_128 6 ISBT128 7 EAN8 8 EAN13 9 UPCE 10 UPCA 11 ISBN 12 ISSN 13 CODE39 14 CODE93 15 93I 16 CODABAR 17 ITF 18 ITF6 19 ITF14 20 DPLEITCODE 21 DPIDENTCODE 22 CHNPOST25 23 STANDARD25 23 IATA25 24 MATRIX25 25 INDUSTRIAL25 26 COOP25 27 CODE11 28 MSIPLESSEY 29 PLESSEY 30 RSS14 31 RSSLIMITED 32 RSSEXPANDED 33 TELEPEN 34 CHANNELCODE 35 CODE32 36 CODEZ Date:2018/12/20 Page : 9 / 11
37 CODABLOCKF 38 CODABLOCKA 39 CODE49 40 CODE16K 41 HIBC128 42 HIBC39 43 RSSFAMILY 44 TriopticCODE39 45 UPC_E1 256 PDF417 257 MICROPDF 258 QRCODE 259 MICROQR 260 AZTEC 261 DATAMATRIX 262 MAXICODE 263 CSCODE 264 GRIDMATRIX 265 EARMARK 266 VERICODE 267 CCA 268 CCB 269 CCC 270 COMPOSITE 271 HIBCAZT 272 HIBCDM 273 HIBCMICROPDF 274 HIBCQR 512 POSTNET 513 ONECODE 514 RM4SCC 515 PLANET 516 KIX 517 APCUSTOM 518 APREDIRECT 519 APREPLYPAID 520 APROUTING 768 NUMOCRB 769 PASSPORT 770 TD1 2048 PRIVATE 2049 ZZCODE 65535 UNKNOWN Date:2018/12/20 Page : 10 / 11
Date:2018/12/20 Page : 11 / 11