للعثور على أجهزة BLE، يمكنك استخدام طريقة startScan. تتطلّب هذه الطريقة
ScanCallback كمَعلمة. يجب تنفيذ هذا الاستدعاء، لأنّ هذه هي الطريقة التي يتم بها عرض نتائج المسح الضوئي. بما أنّ عملية المسح تستهلك قدرًا كبيرًا من طاقة البطارية،
عليك اتّباع الإرشادات التالية:
- بمجرد العثور على الجهاز الذي تريده، أوقِف المسح.
- لا تفحص أبدًا في حلقة، واضبط دائمًا حدًا زمنيًا للفحص. قد يكون الجهاز الذي كان متاحًا في السابق قد خرج عن النطاق، والاستمرار في البحث يستنزف البطارية.
في المثال التالي، يوفّر تطبيق BLE نشاطًا (DeviceScanActivity) للبحث عن أجهزة بلوتوث منخفض الطاقة المتاحة وعرضها في قائمة للمستخدم. يوضّح المقتطف التالي كيفية بدء عملية مسح ضوئي وإيقافها:
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، وهي الواجهة المستخدَمة لعرض نتائج البحث عن الأجهزة التي تتضمّن بلوتوث منخفض الطاقة. عند العثور على نتائج، تتم إضافتها إلى محوّل قائمة في 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();
}
};