Stay organized with collections
    
    
      
      Save and categorize content based on your preferences.
    
  
  
    
  
  
  
  
    
    
    
  
  
    
    
  
  
AssociationRequest.Builder
  public
  static
  final
  
  class
  AssociationRequest.Builder
  
    extends Object
  
  
  
  
  
  
  
    
  A builder for AssociationRequest
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
    addDeviceFilter
    
public AssociationRequest.Builder addDeviceFilter (DeviceFilter<?> deviceFilter)
    
    
    
  
    
    | Parameters | 
|---|
      
        | deviceFilter | DeviceFilter: if set, only devices matching the given filter will be shown to the
                     user
 This value may benull. | 
    
    
 
    setDeviceProfile
    
public AssociationRequest.Builder setDeviceProfile (String deviceProfile)
    
    
    
  If set, association will be requested as a corresponding kind of device
    
    
 
    setDisplayName
    
public AssociationRequest.Builder setDisplayName (CharSequence displayName)
    
    
    
  Adds a display name.
 Generally AssociationRequests are not required to provide a display name, except
 for request for creating "self-managed" associations, which MUST provide a display name.
    
    | Parameters | 
|---|
      
        | displayName | CharSequence: the display name of the device.
 This value cannot benull. | 
    
    
 
    setSingleDevice
    
public AssociationRequest.Builder setSingleDevice (boolean singleDevice)
    
    
    
  Whether only a single device should match the provided filter.
 When scanning for a single device with a specific BluetoothDeviceFilter mac
 address, bonded devices are also searched among. This allows to obtain the necessary app
 privileges even if the device is already paired.
    
    | Parameters | 
|---|
      
        | singleDevice | boolean: if true, scanning for a device will stop as soon as at least one
                     fitting device is found | 
    
    
 
 
 
  
  
    
  
 
  
    
      
      
    
    
      
    
    
  
       
    
    
      
    
  
  
  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."],[],[]]