BLE デバイスを検出するには、startScan メソッドを使用します。このメソッドは、パラメータとして ScanCallback を受け取ります。スキャン結果はこのコールバックで返されるため、このコールバックを実装する必要があります。スキャンはバッテリーを大量に消費するため、次のガイドラインを遵守する必要があります。
- 目的のデバイスが見つかったら、スキャンを停止します。
- ループでスキャンしないでください。また、スキャンには必ず制限時間を設定してください。以前は利用可能だったデバイスが範囲外に移動した可能性があり、スキャンを続けるとバッテリーが消耗します。
次の例では、BLE アプリが、利用可能な Bluetooth LE デバイスをスキャンしてユーザーにリスト表示するアクティビティ(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 オブジェクトを指定します。
次のコードサンプルは、BLE スキャン結果の配信に使用されるインターフェースである 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();
}
};