Most visited

Recently visited

Added in API level 21

BluetoothLeScanner

public final class BluetoothLeScanner
extends Object

java.lang.Object
   ↳ android.bluetooth.le.BluetoothLeScanner


此类提供了执行蓝牙LE设备扫描相关操作的方法。 应用程序可以使用ScanFilter扫描特定类型的蓝牙LE设备。 它也可以请求不同类型的回调来传递结果。

使用 getBluetoothLeScanner()获得的实例 BluetoothLeScanner

注意:这里的大多数扫描方法都需要 BLUETOOTH_ADMIN权限。

也可以看看:

Summary

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

Public methods

flushPendingScanResults

Added in API level 21
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.

startScan

Added in API level 21
void startScan (ScanCallback callback)

使用默认参数启动Bluetooth LE扫描并且不使用过滤器。 扫描结果将通过callback

需要BLUETOOTH_ADMIN权限。 一个应用必须拥有ACCESS_COARSE_LOCATIONACCESS_FINE_LOCATION权限才能获得结果。

Parameters
callback ScanCallback: Callback used to deliver scan results.
Throws
IllegalArgumentException If callback is null.

startScan

Added in API level 21
void startScan (List<ScanFilter> filters, 
                ScanSettings settings, 
                ScanCallback callback)

开始蓝牙LE扫描。 扫描结果将通过callback

需要BLUETOOTH_ADMIN权限。 应用程序必须拥有ACCESS_COARSE_LOCATIONACCESS_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.

stopScan

Added in API level 21
void stopScan (ScanCallback callback)

停止正在进行的蓝牙LE扫描。

需要 BLUETOOTH_ADMIN权限。

Hooray!