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 be null. | 
      
    
    
 
    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 be null. | 
      
    
    
 
    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."],[],[]]