public class ScanSettings
- Object
- ScanSettings
Options for a BLE scan started via
BluetoothLE.startScan(ScanSettings, ScanListener). Fluent setters
return this for chaining.Constructors
public ScanSettings() |
Methods
public ScanSettings setScanMode(ScanMode mode) | The power/latency trade-off; defaults to ScanMode.BALANCED. |
public ScanSettings setAllowDuplicates(boolean allow) | When false (the default) each device is reported once per scan; when true every advertisement sighting is reported – required for RSSI tracking and beacon monitoring. |
public ScanSettings addFilter(ScanFilter filter) | Adds a filter; multiple filters are OR-combined. |
public ScanMode getScanMode() | The configured scan mode. |
public boolean isAllowDuplicates() | Whether duplicate sightings are reported. |
public List<ScanFilter> getFilters() | The filters added via addFilter(ScanFilter); empty means match-all. |
public boolean matches(ScanResult result) | true when the given result passes this settings object’s filter set (no filters == match all). |
Inherited methods
Constructor details
ScanSettings
public ScanSettings()Method details
setScanMode
public ScanSettings setScanMode(ScanMode mode)The power/latency trade-off; defaults to
ScanMode.BALANCED.setAllowDuplicates
public ScanSettings setAllowDuplicates(boolean allow)When
false (the default) each device is reported once per scan;
when true every advertisement sighting is reported – required
for RSSI tracking and beacon monitoring.addFilter
public ScanSettings addFilter(ScanFilter filter)Adds a filter; multiple filters are OR-combined. A scan without
filters reports every advertising device.
getScanMode
public ScanMode getScanMode()The configured scan mode.
isAllowDuplicates
public boolean isAllowDuplicates()Whether duplicate sightings are reported.
getFilters
public List<ScanFilter> getFilters()The filters added via
addFilter(ScanFilter); empty means
match-all.matches
public boolean matches(ScanResult result)true when the given result passes this settings object’s filter
set (no filters == match all). Used by the core scan
demultiplexer.