core-service/org.meshtastic.core.service/ServiceClient

ServiceClient

open class ServiceClient<T : IInterface>(stubFactory: (IBinder) -> T) : Closeable(source)

A generic helper for binding to an Android Service via AIDL. Handles connection lifecycle, thread safety for initial binding, and automatic retry for common race conditions.

Parameters

stubFactory

A factory function to convert an IBinder to the interface type.

Type Parameters

The type of the AIDL interface.

Constructors

ServiceClient

constructor(stubFactory: (IBinder) -> T)

Properties

service

val service: T

Returns the bound service instance. If not currently connected, this will block the current thread until the connection is established.

serviceP

var serviceP: T?

The currently bound service instance, or null if not connected.

Functions

open override fun close()

connect

suspend fun connect(c: Context, intent: Intent, flags: Int)

Initiates a binding to the service.

onConnected

open fun onConnected(service: T)

Called on the main thread when the service is connected.

onDisconnected

open fun onDisconnected()

Called on the main thread when the service connection is lost.

waitConnect

fun waitConnect()

Blocks the current thread until the service is connected.