Pour rechercher des appareils BLE, utilisez la méthode startScan. Cette méthode utilise un objet ScanCallback comme paramètre. Vous devez implémenter ce rappel, car c'est ainsi que les résultats de l'analyse sont renvoyés. La recherche de balises consomme beaucoup d'énergie. Vous devez donc respecter les consignes suivantes :
- Dès que vous trouvez l'appareil souhaité, arrêtez l'analyse.
- N'effectuez jamais d'analyse en boucle et définissez toujours une limite de temps pour votre analyse. Un appareil qui était auparavant disponible peut être hors de portée, et continuer à rechercher des appareils décharge la batterie.
Dans l'exemple suivant, l'application BLE fournit une activité (DeviceScanActivity) pour rechercher les appareils Bluetooth LE disponibles et les afficher dans une liste pour l'utilisateur. L'extrait de code suivant montre comment démarrer et arrêter une analyse :
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);
}
}
Pour rechercher uniquement des types de périphériques spécifiques, vous pouvez appeler startScan(List<ScanFilter>, ScanSettings, ScanCallback) en fournissant une liste d'objets ScanFilter qui limitent les appareils recherchés par l'analyse et un objet ScanSettings qui spécifie les paramètres de l'analyse.
L'exemple de code suivant est une implémentation de ScanCallback, qui est l'interface utilisée pour fournir les résultats de l'analyse BLE. Lorsque des résultats sont trouvés, ils sont ajoutés à un adaptateur de liste dans DeviceScanActivity pour être affichés à l'utilisateur.
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();
}
};