public final class BluetoothLeScanner
extends Object
| java.lang.Object | |
| ↳ | android.bluetooth.le.BluetoothLeScanner |
此类提供了执行蓝牙LE设备扫描相关操作的方法。 应用程序可以使用ScanFilter扫描特定类型的蓝牙LE设备。 它也可以请求不同类型的回调来传递结果。
使用 getBluetoothLeScanner()获得的实例 BluetoothLeScanner 。
注意:这里的大多数扫描方法都需要 BLUETOOTH_ADMIN权限。
也可以看看:
Public methods |
|
|---|---|
void |
flushPendingScanResults(ScanCallback callback) 刷新存储在蓝牙控制器中的批量扫描结果。 |
void |
startScan(ScanCallback callback) 使用默认参数启动Bluetooth LE扫描并且不使用过滤器。 |
void |
startScan(List<ScanFilter> filters, ScanSettings settings, ScanCallback callback) 开始蓝牙LE扫描。 |
void |
stopScan(ScanCallback callback) 停止正在进行的蓝牙LE扫描。 |
Inherited methods |
|
|---|---|
java.lang.Object
|
|
void flushPendingScanResults (ScanCallback callback)
刷新存储在蓝牙控制器中的批量扫描结果。 这将返回在蓝牙控制器上批量分配的蓝牙LE扫描结果。 立即返回,批量扫描结果数据将通过callback 。
| Parameters | |
|---|---|
callback |
ScanCallback: Callback of the Bluetooth LE Scan, it has to be the same instance as the one used to start scan. |
void startScan (ScanCallback callback)
使用默认参数启动Bluetooth LE扫描并且不使用过滤器。 扫描结果将通过callback 。
需要BLUETOOTH_ADMIN权限。 一个应用必须拥有ACCESS_COARSE_LOCATION或ACCESS_FINE_LOCATION权限才能获得结果。
| Parameters | |
|---|---|
callback |
ScanCallback: Callback used to deliver scan results. |
| Throws | |
|---|---|
IllegalArgumentException |
If callback is null. |
void startScan (List<ScanFilter> filters, ScanSettings settings, ScanCallback callback)
开始蓝牙LE扫描。 扫描结果将通过callback 。
需要BLUETOOTH_ADMIN权限。 应用程序必须拥有ACCESS_COARSE_LOCATION或ACCESS_FINE_LOCATION权限才能获得结果。
| Parameters | |
|---|---|
filters |
List: ScanFilters for finding exact BLE devices. |
settings |
ScanSettings: Settings for the scan. |
callback |
ScanCallback: Callback used to deliver scan results. |
| Throws | |
|---|---|
IllegalArgumentException |
If settings or callback is null. |
void stopScan (ScanCallback callback)
停止正在进行的蓝牙LE扫描。
需要 BLUETOOTH_ADMIN权限。