Android外接USB扫码枪

前言

公司的设备以前接入的都是串口的扫码头,优点是直接通过串口读取流里面的数据就OK了,缺点是你需要知道每一款扫码器的型号以获取波特率及Android设备的串口地址。因为现在usb扫码器越来越方便且即插即用,不需要额外供电以及价格便宜等特点,公司以后开发的设备都打算采用usb扫码器。所以我开始尝试接入usb扫码器,下面就是我在接入时的方法以及遇到的一些问题。

1. USB扫码器接入

  • 前面我有说过,usb扫码器接入方便,即插即用,但是有个很大的坑,因为它的实质其实就是相当于设备的外接键盘,也就是它必须在有光标的地方才能进行扫码,且是直接把扫到的内容自动输入到输入框中,并不受我们的控制。但是我们在很多时候并不需要一个edittext的输入框的,而这时要么就是重新改设计,要么就是我们自己想办法解决这个问题。
  • 最开始的时候我是利用1个宽高都为1px的Edittext作为扫码头的接收器,并且让它自动获取焦点,这样我们就能实时地获取到扫码头传过来的数据了。但是这种方法并不能作为一个通用的方法,且每个项目都不能复用,还会和我们页面中其它Edittext输入框冲突,这个方法也就被我弃用了。
  • 接下来说到的就是我现在用到的方法,我们知道,USB扫码器实质就是一个外接键盘,那么我们可不可以对它进行键盘的输入拦截呢,安卓系统中有这么个方法dispatchKeyEvent(KeyEvent event),它就是用来处理我们键盘的输入事件的,如果我们拦截该方法,把它交给我们自己去处理,这样我们就可以不通过Edittext从而获取到扫码头传过来的数据了。
  • 我自定义了一个叫ScanKeyManager的拦截键盘事件并将它转化成我们需要的数据的管理类代码如下:
import android.view.KeyEvent;

public class ScanKeyManager {

    private StringBuilder mResult;
    public OnScanValueListener mListener;
    private boolean mCaps;

    public interface OnScanValueListener {
        void onScanValue(String value);
    }

    public ScanKeyManager(OnScanValueListener listener) {
        this.mListener = listener;
        this.mResult = new StringBuilder();
    }

    /**
     * 扫码设备事件解析
     */
    public void analysisKeyEvent(KeyEvent event) {
        int keyCode = event.getKeyCode();
        checkLetterStatus(event);
        if (event.getAction() == KeyEvent.ACTION_DOWN) {
            char aChar = getInputCode(mCaps, event.getKeyCode());
            if (aChar != 0) {
                mResult.append(aChar);
            }
            if (keyCode == KeyEvent.KEYCODE_ENTER) {
                if (mListener != null) {
                    mListener.onScanValue(mResult.toString());
                }
                mResult.delete(0, mResult.length());
            }
        }
    }

    /**
     * 判断大小写
     */
    private void checkLetterStatus(KeyEvent event) {
        int keyCode = event.getKeyCode();
        if (keyCode == KeyEvent.KEYCODE_SHIFT_RIGHT || keyCode == KeyEvent.KEYCODE_SHIFT_LEFT) {
            mCaps = event.getAction() == KeyEvent.ACTION_DOWN;
        }
    }

    /**
     * 将keyCode转为char
     *
     * @param caps    是不是大写
     * @param keyCode 按键
     * @return 按键对应的char
     */
    private char getInputCode(boolean caps, int keyCode) {
        if (keyCode >= KeyEvent.KEYCODE_A && keyCode <= KeyEvent.KEYCODE_Z) {
            return (char) ((caps ? 'A' : 'a') + keyCode - KeyEvent.KEYCODE_A);
        } else {
            return keyValue(caps, keyCode);
        }
    }

    /**
     * 按键对应的char表
     */
    private char keyValue(boolean caps, int keyCode) {
        switch (keyCode) {
            case KeyEvent.KEYCODE_0:
                return caps ? ')' : '0';
            case KeyEvent.KEYCODE_1:
                return caps ? '!' : '1';
            case KeyEvent.KEYCODE_2:
                return caps ? '@' : '2';
            case KeyEvent.KEYCODE_3:
                return caps ? '#' : '3';
            case KeyEvent.KEYCODE_4:
                return caps ? '$' : '4';
            case KeyEvent.KEYCODE_5:
                return caps ? '%' : '5';
            case KeyEvent.KEYCODE_6:
                return caps ? '^' : '6';
            case KeyEvent.KEYCODE_7:
                return caps ? '&' : '7';
            case KeyEvent.KEYCODE_8:
                return caps ? '*' : '8';
            case KeyEvent.KEYCODE_9:
                return caps ? '(' : '9';
            case KeyEvent.KEYCODE_NUMPAD_SUBTRACT:
                return '-';
            case KeyEvent.KEYCODE_MINUS:
                return '_';
            case KeyEvent.KEYCODE_EQUALS:
                return '=';
            case KeyEvent.KEYCODE_NUMPAD_ADD:
                return '+';
            case KeyEvent.KEYCODE_GRAVE:
                return caps ? '~' : '`';
            case KeyEvent.KEYCODE_BACKSLASH:
                return caps ? '|' : '\\';
            case KeyEvent.KEYCODE_LEFT_BRACKET:
                return caps ? '{' : '[';
            case KeyEvent.KEYCODE_RIGHT_BRACKET:
                return caps ? '}' : ']';
            case KeyEvent.KEYCODE_SEMICOLON:
                return caps ? ':' : ';';
            case KeyEvent.KEYCODE_APOSTROPHE:
                return caps ? '"' : '\'';
            case KeyEvent.KEYCODE_COMMA:
                return caps ? '<' : ',';
            case KeyEvent.KEYCODE_PERIOD:
                return caps ? '>' : '.';
            case KeyEvent.KEYCODE_SLASH:
                return caps ? '?' : '/';
            default:
                return 0;
        }
    }
}

在该类中,我拦截处理了键盘输入事件的绝大部分字符,并把它转化成我们需要的数据通过接口回调传给我们需要用到的页面。

  • 用法如下
  1. 在activity中使用
import android.os.Bundle;
import android.support.annotation.Nullable;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.KeyEvent;

public class MainActivity extends AppCompatActivity {
    private ScanKeyManager scanKeyManager;
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //拦截扫码器回调,获取扫码内容
        scanKeyManager = new ScanKeyManager(new ScanKeyManager.OnScanValueListener() {
            @Override
            public void onScanValue(String value) {
                Log.e("ScanValue", value);
            }
        });
    }

    /*监听键盘事件,除了返回事件都将它拦截,使用我们自定义的拦截器处理该事件*/
    @Override
    public boolean dispatchKeyEvent(KeyEvent event) {
        if (event.getKeyCode() != KeyEvent.KEYCODE_BACK) {
            scanKeyManager.analysisKeyEvent(event);
            return true;
        }
        return super.dispatchKeyEvent(event);
    }
}
  1. 在dialog中使用
public class ScanDialog extends Dialog {

    private ScanKeyManager scanKeyManager;
    private OnScanDialogListener mListener;

    public ScanDialog(Context context) {
        super(context, R.style.LoadDialogStyle);
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        this.setContentView(R.layout.dialog_scan);
        setCanceledOnTouchOutside(false);
        scanKeyManager = new ScanKeyManager(new ScanKeyManager.OnScanValueListener() {
            @Override
            public void onScanValue(String value) {
                Log.e("dialog", value);
                if (mListener == null) return;
                mListener.onScanResult(value);
            }
        });
    }

    @Override
    public boolean dispatchKeyEvent(@NonNull KeyEvent event) {
        scanKeyManager.analysisKeyEvent(event);
        return true;
    }

    public interface OnScanDialogListener {
        void onScanResult(String scanValue);
    }

    public void setOnScanDialogListener(OnScanDialogListener listener) {
        mListener = listener;
    }
}

使用起来都是比较简单,只需要创建键盘拦截管理类,并设置监听回调,以及复写dispatchKeyEvent(KeyEvent event)拦截键盘事件就ok了,如果是dialog中使用则多了一个接口回调的步骤。

2. 遇到的问题

如果按照上述的方法去做是可以做到完美监听扫码器扫码事件的,但是我在实际使用中还遇到了一个比较严重问题,就是如果页面中有Edittext输入框的时候,如果我使用该方法拦截键盘事件之后,会出现数字,一些符号,以及删除键等一些字符输入无效的问题,好像这样我们在使用键盘拦截的时候就没法使用键盘输入了,那该怎么办呢?

3. 解决办法

上面我们说到,使用键盘拦截的时候就没法使用键盘输入了,那么有没有一种可能,就是我在键盘输入的时候不拦截键盘事件,不输入的时候我才进行拦截呢?这个时候就需要监听软键盘的显示和隐藏事件了,但是安卓系统所提供的api当中是没有监听键盘事件的,那么如果需要监听键盘事件就需要我们自定义了,我的另一篇文章中就对键盘的显示隐藏事件监听有比较好的解决办法,有兴趣的同学可以去看看Android软键盘显示隐藏事件监听。下面就开始上代码:

import android.os.Bundle;
import android.support.annotation.Nullable;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.KeyEvent;

public class SecondActivity extends AppCompatActivity {

    private ScanKeyManager scanKeyManager;
    /*是否是输入状态(输入时扫码监听不拦截)*/
    private boolean isInput = false;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_second);
        onKeyBoardListener();
        //拦截扫码器回调,获取扫码内容
        scanKeyManager = new ScanKeyManager(new ScanKeyManager.OnScanValueListener() {
            @Override
            public void onScanValue(String value) {
                Log.e("ScanValue", value);
            }
        });
    }

    /*监听键盘事件,除了返回事件都将它拦截,使用我们自定义的拦截器处理该事件*/
    @Override
    public boolean dispatchKeyEvent(KeyEvent event) {
        if (event.getKeyCode() != KeyEvent.KEYCODE_BACK && !isInput) {
            scanKeyManager.analysisKeyEvent(event);
            return true;
        }
        return super.dispatchKeyEvent(event);
    }

    //监听软件盘是否弹起
    private void onKeyBoardListener() {
        SoftKeyBoardListener.setListener(this, new SoftKeyBoardListener.OnSoftKeyBoardChangeListener() {
            @Override
            public void keyBoardShow(int height) {
                Log.e("软键盘", "键盘显示 高度" + height);
                isInput = true;
            }

            @Override
            public void keyBoardHide(int height) {
                Log.e("软键盘", "键盘隐藏 高度" + height);
                isInput = false;
            }
        });
    }
}

那么,这个时候就可以完美解决usb扫码器的监听问题啦,可能还会有小伙伴会问,那我在键盘弹起的时候岂不是就不能用扫码头了?这个其实不用担心,当我们不拦截键盘事件的时候,且Edittext获取焦点时,那么扫到的内容就会被自动输入到输入框中了。

总结

这是我摸索出来的算是比较完美解决usb扫码器使用的办法了,当然如果哪位同学有更好的解决办法,也欢迎你在下方留言。如果文章中哪里有错误也希望大家多多指正!٩(•̤̀ᵕ•̤́๑)ᵒᵏᵎᵎ

推荐阅读更多精彩内容