Added in API level 26

Builder


class Builder
kotlin.Any
   ↳ android.companion.AssociationRequest.Builder

A builder for AssociationRequest

Summary

Public constructors

Public methods
AssociationRequest.Builder
addDeviceFilter(deviceFilter: DeviceFilter<*>?)

AssociationRequest

AssociationRequest.Builder
setDeviceProfile(deviceProfile: String)

If set, association will be requested as a corresponding kind of device

AssociationRequest.Builder

Adds a display name.

AssociationRequest.Builder
setForceConfirmation(forceConfirmation: Boolean)

Indicates whether the application requires the CompanionDeviceManager service to collect an explicit confirmation from the user before creating an association, even if such confirmation is not required from the service's perspective.

AssociationRequest.Builder
setSelfManaged(selfManaged: Boolean)

Indicate whether the association would be managed by the companion application.

AssociationRequest.Builder
setSingleDevice(singleDevice: Boolean)

Whether only a single device should match the provided filter.

Public constructors

Builder

Added in API level 26
Builder()

Public methods

addDeviceFilter

Added in API level 26
fun addDeviceFilter(deviceFilter: DeviceFilter<*>?): AssociationRequest.Builder
Parameters
deviceFilter DeviceFilter<*>?: if set, only devices matching the given filter will be shown to the user This value may be null.
Return
AssociationRequest.Builder This value cannot be null.

build

Added in API level 26
fun build(): AssociationRequest
Return
AssociationRequest This value cannot be null.

setDisplayName

Added in API level 33
fun setDisplayName(displayName: CharSequence): AssociationRequest.Builder

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.
Return
AssociationRequest.Builder This value cannot be null.

setForceConfirmation

Added in API level 33
fun setForceConfirmation(forceConfirmation: Boolean): AssociationRequest.Builder

Indicates whether the application requires the CompanionDeviceManager service to collect an explicit confirmation from the user before creating an association, even if such confirmation is not required from the service's perspective.
Requires android.Manifest.permission#REQUEST_COMPANION_SELF_MANAGED

Return
AssociationRequest.Builder This value cannot be null.

setSelfManaged

Added in API level 33
fun setSelfManaged(selfManaged: Boolean): AssociationRequest.Builder

Indicate whether the association would be managed by the companion application. Requests for creating "self-managed" association MUST provide a Display name.
Requires android.Manifest.permission#REQUEST_COMPANION_SELF_MANAGED

Return
AssociationRequest.Builder This value cannot be null.

setSingleDevice

Added in API level 26
fun setSingleDevice(singleDevice: Boolean): AssociationRequest.Builder

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
Return
AssociationRequest.Builder This value cannot be null.