client-core-android/no.nordicsemi.kotlin.ble.client.android/CentralManager/ConnectionOptions/Direct

Direct

data class Direct(val timeout: Duration = 10.seconds, val retry: Int = 2, val retryDelay: Duration = 300.milliseconds, val automaticallyRequestHighestValueLength: Boolean = true, val opportunistic: Boolean = false) : CentralManager.ConnectionOptions

Connection options for direct connection.

Direct connection has a maximum timeout which depends on the device manufacturer and is usually 30 seconds or less. It may be shortened using the timeout parameter.

Constructors

Direct

constructor(timeout: Duration = 10.seconds, retry: Int = 2, retryDelay: Duration = 300.milliseconds, automaticallyRequestHighestValueLength: Boolean = true, opportunistic: Boolean = false)

Properties

automaticallyRequestHighestValueLength

open override val automaticallyRequestHighestValueLength: Boolean

If true, the manager will automatically request the highest MTU supported by the remote device immediately after establishing the connection.

opportunistic

open override val opportunistic: Boolean

Opportunistic connection is available from Android 17 onwards. An opportunistic GATT client does not hold a GATT connection. It automatically disconnects when no other GATT connections are active for the remote device.

retry

val retry: Int

The number of connection retries. Value N indicates N+1 connection attempts.

retryDelay

val retryDelay: Duration

The delay between connection retries, defaults to 300 ms.

timeout

val timeout: Duration

The connection timeout, defaults to 10 seconds. If set to a longer time than the system timeout (around 30 seconds) the connection will still timeout after the default timer. Use AutoConnect instead.