项目中的要使用扫码枪录入商品条码,读取微信、支付宝的付款码。在调试的过程中,遇到一些问题,在这里做个总结。

扫码枪使即插即用的输入设备,不需要软件驱动,PC、Android 机器都可以使用。它读取一串数字或者字母,然后以回车键结束,用文本表示就是这样的 1234567890\n

要实现的功能是,一直不断地扫码输入,扫完一个继续下一个,类似于超市里面的收银结账。下次输入的时候要清空之前的字符,如何判读输入的开始是关键,但是这个没有一个标准。考虑过后,我用一个输入框的「隐形替身」来完成聚焦,读到字符串后用另外的 EditText 显示。试过之后发现它完美解决了我的问题。

来看代码:

public class BarcodeInputWatcher implements View.OnFocusChangeListener, TextWatcher, TextView.OnEditorActionListener {
    private final ILogger logger = LoggerFactory.getLogger(BarcodeInputWatcher.class);
    private static final long ONE_MILLION = 1000000;
    /**
     * 判定扫描枪输入的最小间隔,模拟器3000毫秒,真机300毫秒
     */
    private static final int BARCODE_INPUT_INTERVAL = 300;
    // 开始输入的时刻
    private long mBeginning;
    // 扫码监听器
    private OnBarcodeInputListener mOnBarcodeInputListener;
    // 替身 EditText,通过构造方法传入
    private EditText mEditText;

    public BarcodeInputWatcher(EditText editText) {
        editText.setOnEditorActionListener(this);
        editText.setOnFocusChangeListener(this);
        editText.addTextChangedListener(this);
        mEditText = editText;
    }

    public void setOnBarcodeInputListener(OnBarcodeInputListener onBarcodeInputListener) {
        mOnBarcodeInputListener = onBarcodeInputListener;
    }

    @Override
    public boolean onEditorAction(TextView v, int actionId, KeyEvent event) {
        // 监听回车键. 这里注意要作判断处理,ActionDown、ActionUp 都会回调到这里,不作处理的话就会调用两次
        boolean isEnter = event != null && event.getKeyCode() == KeyEvent.KEYCODE_ENTER && event.getAction() == KeyEvent.ACTION_DOWN;
        if (isEnter || actionId == EditorInfo.IME_ACTION_DONE) {
            long duration = (System.nanoTime() - mBeginning) / ONE_MILLION;
            String text = v.getText();
            logger.info("点击了 Enter. 输入的字符:{} 耗时{}ms", text, duration);
            if (duration < BARCODE_INPUT_INTERVAL) {
                if (mOnBarcodeInputListener != null) {
                    mOnBarcodeInputListener.onBarcodeInput(text);
                }
            }
            mBeginning = 0;
            mEditText.setText("");
            // 如果返回 false,当输入字符回车时,会自动调用输入框的点击事件
            return true;
        } else {
            return false;
        }
    }

    @Override
    public void onFocusChange(View v, boolean hasFocus) {
        logger.verbose("onFocusChange. hasFocus:{}", hasFocus);
    }

    @Override
    public void beforeTextChanged(CharSequence s, int start, int count, int after) {
        logger.verbose("beforeTextChanged. s:{}, start:{}, count:{}, after:{}", s, start, count, after);
        // 重新输入时,重置计时器
        if (TextUtils.isEmpty(s) || start == 0) {
            mBeginning = System.nanoTime();
        }
    }

    @Override
    public void onTextChanged(CharSequence s, int start, int before, int count) {
        logger.verbose("onTextChanged. s:{}, start:{}, before:{}, count:{}", s, start, before, count);
    }

    @Override
    public void afterTextChanged(Editable s) {
        logger.verbose("afterTextChanged. s:{}", s);
    }

    /**
     * 扫码输入监听器
     */
    public interface OnBarcodeInputListener {
        /**
         * 扫码输入完成
         *
         * @param barcode 输入的条码
         */
        void onBarcodeInput(String barcode);
    }
}

「替身」EditText,指定 1 像素高度,透明的背景和文本,在布局文件中,放在显示条码的 TextView 的旁边。(反正看不见,可以随便放,开玩笑的 ^_^)

<EditText
    android:id="@+id/et_barcode_fake"
    android:layout_width="wrap_content"
    android:layout_height="1dp"
    android:background="@color/transparent"
    android:cursorVisible="false"
    android:imeOptions="actionDone"
    android:inputType="text"
    android:maxLength="20"
    android:textColor="@color/transparent" />

使用时进行初始化,传入要操作的 EditText 和回调接口,并让扫码枪获取焦点。

        EditText mEtBarcodeFake = (EditText) findViewById(R.id.et_barcode_fake);
        
        BarcodeInputWatcher barcodeInputWatcher = new BarcodeInputWatcher(mEtBarcodeFake);
        barcodeInputWatcher.setOnBarcodeInputListener(new BarcodeInputWatcher.OnBarcodeInputListener() {
            @Override
            public void onBarcodeInput(String barcode) {
                // 处理输入的条码,用 TextView 显示出来
            }
        });

        mEtBarcodeFake.requestFocus();
        mEtBarcodeFake.requestFocusFromTouch();

到这儿,扫码枪的输入已经可以由我们控制,业务也可以顺利进行下去啦。

回过头来看,这种方法和代理模式很像,显示字符的 EditText 是被代理对象,把接受输入的操作交给代理来做;「替身」EditText 是代理对象,输入字符后交给被代理者显示。一个是显性的,一个是隐性的,搭配在一起就可以实现功能。