Stay organized with collections
    
    
      
      Save and categorize content based on your preferences.
    
  
  
    
  
  
  
  
    
    
    
  
  
    
    
  
  
ScanSettings.Builder
  public
  static
  final
  
  class
  ScanSettings.Builder
  
    extends Object
  
  
  
  
  
  
  
    
  Builder for ScanSettings.
Summary
| Inherited methods | 
|---|
| 
    From class
      
        
          java.lang.Object
        
      
      
  
  
  
    | 
        
        
        
        
        
        Object | 
      clone()
      Creates and returns a copy of this object.
        
    
 |  
  
  
    | 
        
        
        
        
        
        boolean | 
      equals(Object obj)
      Indicates whether some other object is "equal to" this one.
        
    
 |  
  
  
    | 
        
        
        
        
        
        void | 
      finalize()
      Called by the garbage collector on an object when garbage collection
 determines that there are no more references to the object.
        
    
 |  
  
  
    | 
        
        
        
        final
        
        Class<?> | 
      getClass()
      Returns the runtime class of this Object. |  
  
  
    | 
        
        
        
        
        
        int | 
      hashCode()
      Returns a hash code value for the object.
        
    
 |  
  
  
    | 
        
        
        
        final
        
        void | 
      notify()
      Wakes up a single thread that is waiting on this object's
 monitor.
        
    
 |  
  
  
    | 
        
        
        
        final
        
        void | 
      notifyAll()
      Wakes up all threads that are waiting on this object's monitor.
        
    
 |  
  
  
    | 
        
        
        
        
        
        String | 
      toString()
      Returns a string representation of the object.
        
    
 |  
  
  
    | 
        
        
        
        final
        
        void | 
      wait(long timeoutMillis, int nanos)
      Causes the current thread to wait until it is awakened, typically
 by being notified or interrupted, or until a
 certain amount of real time has elapsed.
        
    
 |  
  
  
    | 
        
        
        
        final
        
        void | 
      wait(long timeoutMillis)
      Causes the current thread to wait until it is awakened, typically
 by being notified or interrupted, or until a
 certain amount of real time has elapsed.
        
    
 |  
  
  
    | 
        
        
        
        final
        
        void | 
      wait()
      Causes the current thread to wait until it is awakened, typically
 by being notified or interrupted.
        
    
 |  | 
Public constructors
    Builder
    
public Builder ()
    
    
    
  
 
Public methods
    setCallbackType
    
public ScanSettings.Builder setCallbackType (int callbackType)
    
    
    
  Set callback type for Bluetooth LE scan.
    
    | Parameters | 
|---|
      
        | callbackType | int: The callback type flags for the scan. | 
    
    
      
  
 
    setLegacy
    
public ScanSettings.Builder setLegacy (boolean legacy)
    
    
    
  Set whether only legacy advertisements should be returned in scan results. Legacy
 advertisements include advertisements as specified by the Bluetooth core specification
 4.2 and below. This is true by default for compatibility with older apps.
    
    | Parameters | 
|---|
      
        | legacy | boolean: true if only legacy advertisements will be returned | 
    
    
 
    setMatchMode
    
public ScanSettings.Builder setMatchMode (int matchMode)
    
    
    
  Set match mode for Bluetooth LE scan filters hardware match.
    
    
      
  
 
    setNumOfMatches
    
public ScanSettings.Builder setNumOfMatches (int numOfMatches)
    
    
    
  Set the number of matches for Bluetooth LE scan filters hardware match.
    
    
      
  
 
    setReportDelay
    
public ScanSettings.Builder setReportDelay (long reportDelayMillis)
    
    
    
  Set report delay timestamp for Bluetooth LE scan. If set to 0, you will be notified of
 scan results immediately. If > 0, scan results are queued up and delivered after the
 requested delay or 5000 milliseconds (whichever is higher). Note scan results may be
 delivered sooner if the internal buffers fill up.
    
    | Parameters | 
|---|
      
        | reportDelayMillis | long: how frequently scan results should be delivered in milliseconds | 
    
    
      
  
 
    
    
public ScanSettings.Builder setRssiThreshold (int rssiThreshold)
    
    
    
  Sets the RSSI threshold. When filtering by RSSI threshold, an advertisement will pass the
 filter only if its RSSI value is greater than or equal to the specified threshold.
    
    | Parameters | 
|---|
      
        | rssiThreshold | int: the high threshold of RSSI value. The valid range is [-127, 126]. | 
    
    
 
    setScanMode
    
public ScanSettings.Builder setScanMode (int scanMode)
    
    
    
  Set scan mode for Bluetooth LE scan.
    
    
      
  
 
 
 
  
  
    
  
 
  
    
      
      
    
    
      
    
    
  
       
    
    
      
    
  
  
  Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
  Last updated 2025-09-17 UTC.
  
  
  
    
      [[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-17 UTC."],[],[]]