איתור מכשירי BLE

כדי למצוא מכשירי 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();
            }
        };