VehicleObservation

class VehicleObservation(val vehicle_: Vehicle, api: VehicleApi, pollInterval: Duration = Duration.ofMinutes(5)) : AutoCloseable

Periodically polls VehicleApi.getStatus and exposes the latest VehicleStatus as a StateFlow.

Create via rsdev.ovh.weconnect.WeConnect.observe, then call start to begin polling. Collect status to receive updates.

vehicle_

the vehicle to observe

api

the API client used for status polling

pollInterval

time between successive polls (default: 5 minutes)

Constructors

constructor(vehicle_: Vehicle, api: VehicleApi, pollInterval: Duration = Duration.ofMinutes(5))

The latest vehicle status, or null if no poll has completed yet.

Shorthand for the observed vehicle's VIN.

open override fun close()

suspend fun refresh()

Fetches the current status immediately (outside the regular poll cycle).

fun start()

Starts the background polling coroutine. Idempotent -- calling twice has no effect.

fun stop()

Cancels the background polling coroutine without closing the underlying API client.