Aby znaleźć urządzenia BLE, użyj metody startScan. Ta metoda przyjmuje jako parametr obiekt ScanCallback. Musisz zaimplementować to wywołanie zwrotne, ponieważ w ten sposób zwracane są wyniki skanowania. Skanowanie zużywa dużo energii, dlatego przestrzegaj tych wskazówek:
- Gdy znajdziesz odpowiednie urządzenie, zatrzymaj skanowanie.
- Nigdy nie skanuj w pętli i zawsze ustawiaj limit czasu skanowania. Urządzenie, które było wcześniej dostępne, mogło znaleźć się poza zasięgiem, a dalsze skanowanie powoduje rozładowanie baterii.
W poniższym przykładzie aplikacja BLE udostępnia aktywność (DeviceScanActivity) do skanowania dostępnych urządzeń Bluetooth LE i wyświetlania ich użytkownikowi na liście. Poniższy fragment kodu pokazuje, jak rozpocząć i zatrzymać skanowanie:
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);
}
}
Aby skanować tylko określone typy urządzeń peryferyjnych, możesz wywołać metodę startScan(List<ScanFilter>, ScanSettings, ScanCallback), podając listę obiektów ScanFilter, które ograniczają urządzenia wyszukiwane podczas skanowania, oraz obiekt ScanSettings, który określa parametry skanowania.
Poniższy przykładowy kod to implementacja interfejsu ScanCallback, który służy do dostarczania wyników skanowania BLE. Gdy wyniki zostaną znalezione, są dodawane do adaptera listy w DeviceScanActivity, aby wyświetlić je użytkownikowi.
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();
}
};