Added in API level 37

Summary: Nested Classes | Constants | Methods | Inherited Methods

BluetoothGattConnectionSettings

---

Kotlin |Java

public final class BluetoothGattConnectionSettings
extends Object

java.lang.Object
↳	android.bluetooth.BluetoothGattConnectionSettings

---

Defines parameters for creating BluetoothGatt connection.

Used with BluetoothDevice.connectGatt to create a Gatt client connection.

BluetoothDevice.connectGatt ensures It applies the Gatt settings passed as part of BluetoothGattConnectionSettings

See also:

• BluetoothDevice.connectGatt

Summary

Nested classes
class	BluetoothGattConnectionSettings.Builder Builder for BluetoothGattConnectionSettings.

Constants
int	PATHLOSS_THRESHOLD_NOT_SET Value for not using pathloss threshold for triggering the connection.
int	RSSI_THRESHOLD_NOT_SET Value for not using RSSI threshold for triggering the connection.

Public methods
int	getPathlossThresholdDb() Returns the Pathloss threshold (upper bound) in dB for initiating connection.
int	getRssiThresholdDbm() Returns the RSSI threshold (lower bound) in dBm for initiating connection.
int	getTransport() Returns the transport to be used for GATT connection.
boolean	isAutoConnectEnabled() Returns true if auto connection enabled or false otherwise.
boolean	isAutomaticMtuEnabled() Returns true if the automatic MTU exchange is enabled for this connection or false otherwise.
boolean	isOpportunisticEnabled() Returns if the GATT connection is opportunistic or not.
String	toString() Returns a String that describes each BluetoothGattConnectionSettings parameter current value.

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.

Constants

PATHLOSS_THRESHOLD_NOT_SET

Added in API level 10000

public static final int PATHLOSS_THRESHOLD_NOT_SET

Value for not using pathloss threshold for triggering the connection.

Constant Value: -1 (0xffffffff)

RSSI_THRESHOLD_NOT_SET

Added in API level 10000

public static final int RSSI_THRESHOLD_NOT_SET

Value for not using RSSI threshold for triggering the connection.

Constant Value: -128 (0xffffff80)

Public methods

getPathlossThresholdDb

Added in API level 10000

public int getPathlossThresholdDb ()

Returns the Pathloss threshold (upper bound) in dB for initiating connection.

Returns
int	Value is between -1 and 100 inclusive

See also:

• Return {@link #PATHLOSS_THRESHOLD_NOT_SET} if pathloss threshold is not set or a value in range 0 to +100.

getRssiThresholdDbm

Added in API level 10000

public int getRssiThresholdDbm ()

Returns the RSSI threshold (lower bound) in dBm for initiating connection.

Returns
int	Value is between -128 and 20 inclusive

See also:

• Return {@link #RSSI_THRESHOLD_NOT_SET} if rssi threshold is not set or a value in range -127 to +20.

getTransport

Added in API level 37

public int getTransport ()

Returns the transport to be used for GATT connection.

Returns
int	Value is one of the following: BluetoothDevice.TRANSPORT_AUTO BluetoothDevice.TRANSPORT_BREDR BluetoothDevice.TRANSPORT_LE

isAutoConnectEnabled

Added in API level 37

public boolean isAutoConnectEnabled ()

Returns true if auto connection enabled or false otherwise.

Returns
boolean

isAutomaticMtuEnabled

Added in API level 37

public boolean isAutomaticMtuEnabled ()

Returns true if the automatic MTU exchange is enabled for this connection or false otherwise.

Returns
boolean

isOpportunisticEnabled

Added in API level 37

public boolean isOpportunisticEnabled ()

Returns if the GATT connection is opportunistic or not.

Returns
boolean

toString

Added in API level 37

public String toString ()

Returns a String that describes each BluetoothGattConnectionSettings parameter current value.

Returns
String	a string representation of the object.