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 |
|
---|---|
From class 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 : ScanFilter s 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
权限。