Android Studio蓝牙设备搜索问题求助：无法稳定搜索及更新ListView

Hey quark, let’s troubleshoot your Bluetooth app issues step by step. Unstable scanning and devices failing to show up in your ListView are common pitfalls on Android 4.2 (API 17) and 5.1 (API 22)—here’s how to fix them:

1. Double-Check Your Permissions #

Older Android versions require specific Bluetooth permissions, and some 5.1 devices also need location access for reliable scanning. Make sure your AndroidManifest.xml includes these:

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<!-- Required for some 5.1 devices to scan Bluetooth -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-feature android:name="android.hardware.bluetooth" android:required="true" />

2. Fix Bluetooth Adapter Initialization #

Never assume Bluetooth is enabled—explicitly check and request activation:

private static final int REQUEST_ENABLE_BT = 1;
private BluetoothAdapter bluetoothAdapter;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // Get Bluetooth adapter instance
    bluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
    if (bluetoothAdapter == null) {
        Toast.makeText(this, "Your device doesn't support Bluetooth", Toast.LENGTH_SHORT).show();
        finish();
        return;
    }

    // Request to enable Bluetooth if it's off
    if (!bluetoothAdapter.isEnabled()) {
        Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
        startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT);
    }
}

3. Correct Broadcast Receiver Implementation #

The ACTION_FOUND broadcast is how Android delivers scanned devices—if your receiver is misconfigured, you’ll miss devices. Here’s a robust implementation:

private List<BluetoothDevice> deviceList = new ArrayList<>();
private ArrayAdapter<BluetoothDevice> listAdapter;
private BroadcastReceiver bluetoothScanReceiver = new BroadcastReceiver() {
    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        if (BluetoothDevice.ACTION_FOUND.equals(action)) {
            BluetoothDevice discoveredDevice = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);
            
            // Avoid duplicate entries (use device MAC address to check uniqueness)
            boolean deviceExists = false;
            for (BluetoothDevice device : deviceList) {
                if (device.getAddress().equals(discoveredDevice.getAddress())) {
                    deviceExists = true;
                    break;
                }
            }
            
            if (!deviceExists) {
                deviceList.add(discoveredDevice);
                // Update ListView (critical: must run on UI thread)
                runOnUiThread(() -> listAdapter.notifyDataSetChanged());
            }
        } else if (BluetoothAdapter.ACTION_DISCOVERY_FINISHED.equals(action)) {
            Toast.makeText(context, "Scan completed", Toast.LENGTH_SHORT).show();
        }
    }
};

// Register receiver when activity is active, unregister when paused
@Override
protected void onResume() {
    super.onResume();
    IntentFilter filter = new IntentFilter();
    filter.addAction(BluetoothDevice.ACTION_FOUND);
    filter.addAction(BluetoothAdapter.ACTION_DISCOVERY_FINISHED);
    registerReceiver(bluetoothScanReceiver, filter);
}

@Override
protected void onPause() {
    super.onPause();
    unregisterReceiver(bluetoothScanReceiver);
    // Stop scanning to save battery and avoid conflicts
    if (bluetoothAdapter != null && bluetoothAdapter.isDiscovering()) {
        bluetoothAdapter.cancelDiscovery();
    }
}

4. Ensure ListView Updates on the UI Thread #

Broadcast receivers run on a background thread—if you update the ListView directly without runOnUiThread(), the app will either fail to update or crash. The code above already handles this, but double-check your implementation for this common mistake.

5. Optimize Scanning Logic #

Android only allows one Bluetooth scan at a time. Always cancel existing scans before starting a new one:

public void startScan(View scanButton) {
    if (bluetoothAdapter.isDiscovering()) {
        bluetoothAdapter.cancelDiscovery();
    }
    // Clear previous results before new scan
    deviceList.clear();
    listAdapter.notifyDataSetChanged();
    bluetoothAdapter.startDiscovery();
}

Quick Checks for Your Existing Code #

• Did you register the broadcast receiver for ACTION_FOUND?
• Are you updating the ListView adapter on the UI thread?
• Are you checking for duplicate devices before adding to the list?
• Did you stop existing scans before starting a new one?

These fixes should resolve the unstable scanning and missing ListView entries on your Android 4.2/5.1 devices.

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