public class ScanSettings

  1. Object
  2. 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.