כדי למצוא מכשירי BLE, משתמשים בשיטה startScan. ה-method הזו מקבלת את הפרמטר ScanCallback. חובה להטמיע את הקריאה החוזרת הזו, כי ככה מוחזרות תוצאות הסריקה. הסריקה צורכת הרבה סוללה, לכן כדאי לפעול לפי ההנחיות הבאות:
- ברגע שמוצאים את המכשיר הרצוי, מפסיקים את הסריקה.
- אל תסרקו בלולאה, ותמיד הגדירו מגבלת זמן לסריקה. יכול להיות שמכשיר שהיה זמין קודם יצא מהטווח, והמשך הסריקה מרוקן את הסוללה.
בדוגמה הבאה, אפליקציית ה-BLE מספקת פעילות (DeviceScanActivity) לסריקת מכשירי Bluetooth LE זמינים ולהצגתם ברשימה למשתמש. בקטע הקוד הבא אפשר לראות איך מתחילים ומפסיקים סריקה:
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);
}
}
כדי לסרוק רק סוגים ספציפיים של ציוד היקפי, אפשר במקום זאת להפעיל את startScan(List<ScanFilter>, ScanSettings, ScanCallback), ולספק רשימה של אובייקטים מסוג ScanFilter שמגבילים את המכשירים שהסריקה מחפשת, ואובייקט מסוג ScanSettings שמציין פרמטרים לגבי הסריקה.
דוגמת הקוד הבאה היא הטמעה של ScanCallback, שהוא הממשק שמשמש להעברת תוצאות הסריקה של BLE. כשהתוצאות נמצאות, הן מתווספות למתאם רשימה ב-DeviceScanActivity כדי להציג אותן למשתמש.
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();
}
};