BLE cihazlarını bulmak için startScan yöntemini kullanırsınız. Bu yöntem, parametre olarak ScanCallback alır. Tarama sonuçları bu şekilde döndürüldüğü için bu geri çağırma işlevini uygulamanız gerekir. Tarama işlemi çok fazla pil tükettiğinden
aşağıdaki kurallara uymanız gerekir:
- İstediğiniz cihazı bulduğunuzda taramayı durdurun.
- Hiçbir zaman döngüde tarama yapmayın ve taramanız için her zaman bir zaman sınırı belirleyin. Daha önce kullanılabilen bir cihaz kapsama alanı dışına çıkmış olabilir ve taramaya devam etmek pili tüketir.
Aşağıdaki örnekte BLE uygulaması, kullanılabilir Bluetooth LE cihazlarını taramak ve bunları kullanıcıya bir listede göstermek için bir etkinlik (DeviceScanActivity) sağlar. Aşağıdaki snippet'te, taramanın nasıl başlatılacağı ve durdurulacağı gösterilmektedir:
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);
}
}
Yalnızca belirli çevre birimi türlerini taramak için startScan(List<ScanFilter>, ScanSettings, ScanCallback) yöntemini çağırabilirsiniz. Bu yönteme, taramanın aradığı cihazları kısıtlayan ScanFilter nesnelerinin listesini ve taramayla ilgili parametreleri belirten bir ScanSettings nesnesini iletebilirsiniz.
Aşağıdaki kod örneği, BLE tarama sonuçlarını yayınlamak için kullanılan arayüz olan ScanCallback'nin bir uygulamasıdır. Sonuçlar bulunduğunda kullanıcıya gösterilmek üzere DeviceScanActivity içindeki bir liste bağdaştırıcısına eklenir.
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();
}
};