BarcodeAdmin3.0开发文档

开发文档

开发条件

需安装的软件：BarcodeAdmin-3.0.1.apk
简单测试Demo:GetbarcodeDemo.apk
多功能测试Demo：barcodeScanDemo.apk

软件介绍

BarcodeAdmin-3.0.1兼容条码一维/二维扫描，兼容多种机型和条码头，新增功能有：前后缀设置，提示音列表，震动提示，条码类型设置，出光时间设置，连续扫描设置，恢复默认设置及软件版本介绍等。

获取条码的方式

1、通过模拟按键

如果不需要自己开发程序，可以在雨滴商店安装雨滴助手，设置模拟输入，这样在启动外部程序扫描时，可以直接通过模拟输入，将条码数据输入到编辑框中。

在雨滴市场下载雨滴助手
打开雨滴助手中的模拟输入
外部程序输入条码

雨滴助手.jpg

2、通过广播调用

扫描条码可以通过扫描键触发扫描，也可以通过设置扫描按键，通过发送扫描广播来触发扫描。不同的扫描方式接收的广播也不一样，不过可以同时使用。

    public static final String ACTION_OPEN = "raindi.decoder.OPEN";

    public static final String ACTION_CLOSE = "raindi.decoder.CLOSE";
    public static final String ACTION_SCAN = "raindi.decoder.SCAN";
    public static final String ACTION_SCAN_CHARSET = "CHARSET";
    public static final String ACTION_STOP = "raindi.decoder.STOP";
    public static final String ACTION_SAVE_IMG = "raindi.decoder.SAVE_IMG";
    public static final String ACTION_SAVE_IMG_ENABLE = "ENABLE";
    public static final String ACTION_SAVE_IMG_PATH = "PATH";
    public static final String ACTION_RESULT = "raindi.decoder.RESULT";
    public static final String ACTION_RESULT_EXTRA = "DATA";
    private static final String TAG = "NewApiBroadcast";
    private BarcodeReceiver resultReceiver = null;

    public class BarcodeReceiver extends BroadcastReceiver {
        public void onReceive(Context ctx, Intent intent) {
            if (intent.getAction().equals(ACTION_RESULT)) {
                String code = intent.getStringExtra(ACTION_RESULT_EXTRA);

                Log.i(TAG, "code: " + code);
                if (mDecodeCallback != null) {
                    mDecodeCallback.onDecodeComplete(0, code.length(), code.getBytes(), NewApiBroadcast.this);

                }
            }
        }
    } 
     void doScan() {   //通过发送扫描广播来触发扫描
        Intent intent = new Intent(ACTION_SCAN);
        intent.putExtra(ACTION_SCAN_CHARSET, "UTF-8");
        broadcastSend(intent);
    }

    @Override
    void cancelScan() { //取消扫描
        broadcastSend(new Intent(ACTION_STOP));
    }

    void powerOn() {  //开启电源
        broadcastSend(new Intent(ACTION_OPEN));
    }

    void powerOff() {  //关闭电源
        broadcastSend(new Intent(ACTION_CLOSE));
    }

    void imageSave(boolean enable) {  //保存图片（二维扫描头）
        Intent intent = new Intent(ACTION_SAVE_IMG);
        intent.putExtra(ACTION_SAVE_IMG_ENABLE, enable);
        //intent.putExtra(ACTION_SAVE_IMG_PATH, "/sdcard/decodeimage.png");
        broadcastSend(intent);
    }
    private void broadcastSend(Intent intent) {
        if (mContext != null) {
            mContext.sendBroadcast(intent);
        }
    }

当使用按键触发扫描时，只要接收条码服务发送的广播即可。

    public static final String ACTION_RESULT  = "barcodeservice.decoder.RESULT";//接收条码服务发送的广播
    public class BarcodeReceiver extends BroadcastReceiver {
        public void onReceive(Context ctx, Intent intent) {
            if (intent.getAction().equals(ACTION_RESULT)) {
                strBarcode = intent.getStringExtra(ACTION_RESULT_EXTRA);
                tvBarcode.setText(strBarcode);
                strBarcode = "";
            }
        }
    }

通过服务调用

    public class NewApiService extends ScanApi {
    public static final String ACTION_OPEN = "barcodeservice.decoder.OPEN";
    public static final String ACTION_CLOSE = "barcodeservice.decoder.CLOSE";
    public static final String ACTION_SCAN = "barcodeservice.decoder.SCAN";
    public static final String ACTION_SCAN_CHARSET = "CHARSET";

    public static final String ACTION_STOP = "barcodeservice.decoder.STOP";

    public static final String ACTION_SAVE_IMG = "barcodeservice.decoder.SAVE_IMG";
    public static final String ACTION_SAVE_IMG_ENABLE = "ENABLE";
    public static final String ACTION_SAVE_IMG_PATH = "PATH";

    public static final String ACTION_RESULT = "barcodeservice.decoder.RESULT";
    public static final String ACTION_RESULT_EXTRA = "DATA";

    private static final String TAG = "NewApiService";

    private BarcodeReceiver resultReceiver = null;

    public class BarcodeReceiver extends BroadcastReceiver {
        public void onReceive(Context ctx, Intent intent) {
            if (intent.getAction().equals(ACTION_RESULT)) {
                String code = intent.getStringExtra(ACTION_RESULT_EXTRA);

                Log.i(TAG, "code: " + code);
                if (mDecodeCallback != null) {
                    mDecodeCallback.onDecodeComplete(0, code.length(), code.getBytes(), NewApiService.this);

                }
            }
        }
    }

    public void init(Context cnt) {//初始化并注册广播
        super.init(cnt);

        IntentFilter filter = new IntentFilter();
        filter.addAction(ACTION_RESULT);

        if (resultReceiver == null)
            resultReceiver = new BarcodeReceiver();

        mContext.registerReceiver(resultReceiver, filter);
    }

    @Override
    void deInit() {
        powerOff();
        mContext.unregisterReceiver(resultReceiver);
    }

    @Override
    void doScan() { //扫描
        Intent intent = new Intent(ACTION_SCAN);
        intent.putExtra(ACTION_SCAN_CHARSET, "UTF-8");
        broadcastSend(intent);
    }

    @Override
    void cancelScan() { //取消扫描
        broadcastSend(new Intent(ACTION_STOP));
    }

    @Override
    void powerOn() {  //打开电源
        broadcastSend(new Intent(ACTION_OPEN));
    }

    @Override
    void powerOff() { //关闭电源
        broadcastSend(new Intent(ACTION_CLOSE));
    }

    @Override
    void imageSave(boolean enable) {//保存图像
        Intent intent = new Intent(ACTION_SAVE_IMG);
        intent.putExtra(ACTION_SAVE_IMG_ENABLE, enable);
        //intent.putExtra(ACTION_SAVE_IMG_PATH, "/sdcard/decodeimage.png");
        broadcastSend(intent);
    }
    private void broadcastSend(Intent intent) {//启动条码服务
        if (mContext != null) {
            intent.setPackage("com.huayusoft.barcodeadmin");
            mContext.startService(intent);
        }
    }
    }

通过启动条码服务来发送Intent,然后再通过广播接收的方式获得条码数据。

测试结果

ScanTest.png

BarcodeAdmin-3.0设置说明

条码设置页面.png

功能键：左侧键、右侧键、SCAN键
模拟按键：开启时，扫描条码在光标出显示条码；关闭时，在光标出不显示条码
分隔符

ENTER：扫描一条条码后换行，再显示接下来扫描到的条码
TAB：扫描一条条码后空出一个TAB的空格（其间隔稍大于空格键的间隔），再显示接下来扫描到的条码
NONE：扫描一条条码无任何空格，直接再显示接下来扫描到的条码

扫描前缀：可以在条码前添加信息
扫描后缀：可以在条码后添加信息
提示音：扫描获得数据时发出的声音，可以选择提示音类型
指示灯：扫描获得数据时指示灯会亮一下
震动：扫描获得数据时会发生震动
条码类型设置：提供条码头默认的条码类型，并且可以选择开关选择条码
出光时间设置：条码扫描时，如果未扫到码出光的最长时间设置
连续扫描时间：设置连续扫描时，每个多少毫秒扫一次条码
连续扫描：对着条码进行连续扫描
编码格式（默认为UTF-8）

UTF-8: 对收到的条码信息以UTF-8进行解码
GBK: 对收到的条码信息以GBK进行解码

恢复默认设置：恢复初始值
关于条码：关于条码引擎及软件相关信息
二维条码增加免提设置，在手持设备不移动的情况下，可以检测到移动物体中的条码。