开发文档
开发条件
- 需安装的软件：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进行解码
- 恢复默认设置：恢复初始值
- 关于条码：关于条码引擎及软件相关信息
- 二维条码增加免提设置，在手持设备不移动的情况下，可以检测到移动物体中的条码。
