Para encontrar dispositivos BLE, use o método startScan. Esse método usa um ScanCallback como parâmetro. É necessário implementar esse callback, porque
é assim que os resultados da verificação são retornados. Como a verificação consome muita bateria,
siga estas diretrizes:
- Assim que encontrar o dispositivo desejado, interrompa a verificação.
- Nunca faça uma verificação em loop e sempre defina um limite de tempo para ela. Um dispositivo que estava disponível anteriormente pode ter saído do alcance, e continuar a verificação esgota a bateria.
No exemplo a seguir, o app BLE fornece uma atividade
(DeviceScanActivity) para procurar dispositivos Bluetooth LE disponíveis e mostrá-los
em uma lista para o usuário. O snippet a seguir mostra como iniciar e interromper uma
verificação:
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);
}
}
Para procurar apenas tipos específicos de periféricos, chame
startScan(List<ScanFilter>, ScanSettings, ScanCallback), fornecendo uma lista
de objetos ScanFilter que restringem os dispositivos que a verificação procura
e um objeto ScanSettings que especifica parâmetros sobre a verificação.
O exemplo de código a seguir é uma implementação de ScanCallback, que é
a interface usada para fornecer resultados de verificação de BLE. Quando os resultados são encontrados, eles são
adicionados a um adaptador de lista no DeviceScanActivity para serem mostrados ao usuário.
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();
}
};