BLE-Geräte suchen

Verwenden Sie die Methode startScan, um BLE-Geräte zu finden. Diese Methode verwendet ein ScanCallback als Parameter. Sie müssen diesen Callback implementieren, da die Scanergebnisse so zurückgegeben werden. Da das Scannen viel Akkuleistung verbraucht, sollten Sie die folgenden Richtlinien beachten:

  • Beende den Scanvorgang, sobald du das gewünschte Gerät gefunden hast.
  • Scannen Sie niemals in einer Schleife und legen Sie immer ein Zeitlimit für den Scan fest. Ein Gerät, das zuvor verfügbar war, befindet sich möglicherweise nicht mehr in Reichweite. Wenn du weiter suchst, wird der Akku entladen.

Im folgenden Beispiel stellt die BLE-App eine Aktivität (DeviceScanActivity) bereit, um nach verfügbaren Bluetooth LE-Geräten zu suchen und sie dem Nutzer in einer Liste anzuzeigen. Das folgende Snippet zeigt, wie ein Scan gestartet und beendet wird:

Kotlin

private val bluetoothLeScanner = bluetoothAdapter.bluetoothLeScanner
private var scanning = false
private val handler = Handler()

// Stops scanning after 10 seconds.
private val SCAN_PERIOD: Long = 10000

private fun scanLeDevice() {
    if (!scanning) { // Stops scanning after a predefined scan period.
        handler.postDelayed({
            scanning = false
            bluetoothLeScanner.stopScan(leScanCallback)
        }, SCAN_PERIOD)
        scanning = true
        bluetoothLeScanner.startScan(leScanCallback)
    } else {
        scanning = false
        bluetoothLeScanner.stopScan(leScanCallback)
    }
}

Java

private BluetoothLeScanner bluetoothLeScanner = bluetoothAdapter.getBluetoothLeScanner();
private boolean scanning;
private Handler handler = new Handler();

// Stops scanning after 10 seconds.
private static final long SCAN_PERIOD = 10000;

private void scanLeDevice() {
    if (!scanning) {
        // Stops scanning after a predefined scan period.
        handler.postDelayed(new Runnable() {
            @Override
            public void run() {
                scanning = false;
                bluetoothLeScanner.stopScan(leScanCallback);
            }
        }, SCAN_PERIOD);

        scanning = true;
        bluetoothLeScanner.startScan(leScanCallback);
    } else {
        scanning = false;
        bluetoothLeScanner.stopScan(leScanCallback);
    }
}

Wenn Sie nur nach bestimmten Arten von Peripheriegeräten suchen möchten, können Sie stattdessen startScan(List<ScanFilter>, ScanSettings, ScanCallback) aufrufen und eine Liste von ScanFilter-Objekten angeben, die die Geräte einschränken, nach denen der Scan sucht, sowie ein ScanSettings-Objekt, das Parameter für den Scan angibt.

Das folgende Codebeispiel ist eine Implementierung von ScanCallback, der Schnittstelle, die zum Übermitteln von BLE-Scanergebnissen verwendet wird. Wenn Ergebnisse gefunden werden, werden sie einem Listenadapter in der DeviceScanActivity hinzugefügt, um sie dem Nutzer anzuzeigen.

Kotlin

private val leDeviceListAdapter = LeDeviceListAdapter()
// Device scan callback.
private val leScanCallback: ScanCallback = object : ScanCallback() {
    override fun onScanResult(callbackType: Int, result: ScanResult) {
        super.onScanResult(callbackType, result)
        leDeviceListAdapter.addDevice(result.device)
        leDeviceListAdapter.notifyDataSetChanged()
    }
}

Java

private LeDeviceListAdapter leDeviceListAdapter = new LeDeviceListAdapter();

// Device scan callback.
private ScanCallback leScanCallback =
        new ScanCallback() {
            @Override
            public void onScanResult(int callbackType, ScanResult result) {
                super.onScanResult(callbackType, result);
                leDeviceListAdapter.addDevice(result.getDevice());
                leDeviceListAdapter.notifyDataSetChanged();
            }
        };