Android前台服务Java实现条码扫描事件监听及存储需求咨询

一、自研条码扫描监听（保存到文件/弹窗展示） #

如果你的设备使用硬件扫码枪（多数模拟键盘输入），推荐用AccessibilityService在前台服务中捕获扫码事件，稳定性和兼容性更好：

1. 实现AccessibilityService子类 #

该类负责监听系统文本输入事件，识别连续扫码的输入特征：

public class ScanAccessibilityService extends AccessibilityService {
    private final StringBuffer scanBuffer = new StringBuffer();
    private long lastInputTimestamp = 0;
    // 扫码枪连续输入间隔一般小于200ms，以此区分手动输入和扫码
    private static final long SCAN_INTERVAL_THRESHOLD = 200;

    @Override
    public void onAccessibilityEvent(AccessibilityEvent event) {
        if (event.getEventType() != AccessibilityEvent.TYPE_VIEW_TEXT_CHANGED) return;

        CharSequence inputText = event.getText();
        if (inputText == null || inputText.length() == 0) return;

        long currentTime = System.currentTimeMillis();
        // 超过间隔阈值则清空缓存，视为新的扫码输入
        if (currentTime - lastInputTimestamp > SCAN_INTERVAL_THRESHOLD) {
            scanBuffer.setLength(0);
        }
        scanBuffer.append(inputText);
        lastInputTimestamp = currentTime;

        // 扫码枪通常会在条码末尾输入回车，以此判断扫码完成
        String rawInput = scanBuffer.toString();
        if (rawInput.contains("\n") || rawInput.contains("\r")) {
            String barcode = rawInput.replaceAll("[\n\r]", "").trim();
            if (!barcode.isEmpty()) {
                // 回调到前台服务处理结果
                ScanForegroundService.getInstance().processScannedBarcode(barcode);
            }
            scanBuffer.setLength(0);
        }
    }

    @Override
    public void onInterrupt() {}

    @Override
    protected void onServiceConnected() {
        super.onServiceConnected();
        AccessibilityServiceInfo serviceInfo = new AccessibilityServiceInfo();
        serviceInfo.eventTypes = AccessibilityEvent.TYPE_VIEW_TEXT_CHANGED;
        serviceInfo.feedbackType = AccessibilityServiceInfo.FEEDBACK_GENERIC;
        serviceInfo.canRetrieveWindowContent = true;
        setServiceInfo(serviceInfo);
    }
}

2. 注册AccessibilityService #

在AndroidManifest.xml中添加服务声明：

<service
    android:name=".ScanAccessibilityService"
    android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE">
    <intent-filter>
        <action android:name="android.accessibilityservice.AccessibilityService" />
    </intent-filter>
    <meta-data
        android:name="android.accessibilityservice"
        android:resource="@xml/accessibility_service_config" />
</service>

创建res/xml/accessibility_service_config.xml配置文件：

<?xml version="1.0" encoding="utf-8"?>
<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:accessibilityEventTypes="typeViewTextChanged"
    android:accessibilityFeedbackType="feedbackGeneric"
    android:canRetrieveWindowContent="true"
    android:accessibilityFlags="flagDefault" />

3. 前台服务中处理条码结果 #

在已实现的前台服务中添加处理逻辑，完成文件保存和弹窗展示：

public class ScanForegroundService extends Service {
    private static ScanForegroundService instance;

    @Override
    public void onCreate() {
        super.onCreate();
        instance = this;
        // 此处保留你已实现的前台服务启动逻辑
    }

    public static ScanForegroundService getInstance() {
        return instance;
    }

    public void processScannedBarcode(String barcode) {
        // 1. 保存条码到本地文本文件
        saveBarcodeToFile(barcode);
        // 2. 弹窗展示条码（需切换到UI线程）
        new Handler(Looper.getMainLooper()).post(() -> {
            new AlertDialog.Builder(this)
                    .setTitle("扫码成功")
                    .setMessage(barcode)
                    .setPositiveButton("确认", null)
                    .show();
        });
    }

    private void saveBarcodeToFile(String barcode) {
        String logPath = getExternalFilesDir(null) + "/barcode_records.txt";
        try (FileWriter writer = new FileWriter(logPath, true)) {
            String logLine = String.format("%s %s\n",
                    new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date()),
                    barcode);
            writer.write(logLine);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }
}

注意：用户需要手动在系统设置的「辅助功能」中开启你的应用权限，否则AccessibilityService无法正常工作。

二、捕获第三方仓库应用的扫码事件 #

要捕获其他应用的扫码输入，同样依赖AccessibilityService，通过监听目标应用的文本变化实现：

1. 调整AccessibilityService监听范围 #

修改accessibility_service_config.xml，指定仅监听仓库应用（替换为目标应用包名）：

android:packageNames="com.example.warehouse.app"

如果需要监听所有应用，可删除该属性。

2. 识别目标应用的扫码事件 #

在ScanAccessibilityService的onAccessibilityEvent方法中，判断事件来源的应用包名，针对性处理：

@Override
public void onAccessibilityEvent(AccessibilityEvent event) {
    if (event.getEventType() != AccessibilityEvent.TYPE_VIEW_TEXT_CHANGED) return;

    String sourcePackage = event.getPackageName().toString();
    // 仅处理仓库应用的输入事件
    if (!"com.example.warehouse.app".equals(sourcePackage)) return;

    CharSequence inputText = event.getText();
    if (inputText == null || inputText.length() == 0) return;

    String barcode = inputText.toString().trim();
    if (!barcode.isEmpty()) {
        // 保存条码和扫描时间到数据库
        saveToDatabase(barcode, System.currentTimeMillis());
    }
}

private void saveToDatabase(String barcode, long scanTime) {
    // 示例：使用Room数据库（需提前实现数据库实体和DAO）
    new Thread(() -> {
        BarcodeRecord record = new BarcodeRecord();
        record.barcode = barcode;
        record.scanTime = new Date(scanTime);
        record.sourceApp = "仓库应用";
        AppDatabase.getInstance(this).barcodeDao().insert(record);
    }).start();
}

关键注意事项 #

• 跨应用事件捕获必须依赖辅助功能权限，这是Android系统的安全限制，无法绕过；
• 不同仓库应用的扫码实现可能不同：部分应用会将条码显示在EditText，部分可能用自定义控件，此时需要调整监听事件类型（如TYPE_WINDOW_CONTENT_CHANGED）并解析控件内容；
• Android 10+对辅助功能的隐私限制更严格，需确保你的应用符合隐私政策要求。

内容的提问来源于stack exchange，提问作者xralf