如要尋找 BLE 裝置,請使用 startScan 方法。這個方法會將 ScanCallback 做為參數。您必須實作這個回呼,因為這是傳回掃描結果的方式。由於掃描作業會耗用大量電池電力,因此請遵守下列規範:
- 找到所需裝置後,請停止掃描。
- 請勿重複掃描,並務必設定掃描時間限制。先前可用的裝置可能已移出範圍,繼續掃描會消耗電池電力。
在以下範例中,BLE 應用程式提供一個活動 (DeviceScanActivity),用於掃描可用的藍牙 LE 裝置,並以清單形式向使用者顯示。下列程式碼片段說明如何啟動及停止掃描:
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 的實作,這是用於提供 BLE 掃描結果的介面。找到結果後,系統會將結果新增至 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();
}
};