Pleos Connect SDK Release Notes

SDK Versions

These are the major changes in Vehicle SDK v2.3.1. Because the full change set is large, this section focuses on key items.

Target API	Change	Required action
CruiseControl	Removed existing constants and changed state composition OFF, READY, ACTIVE removed. Current states are OTHER, ENABLED, ACTIVATED, USER_OVERRIDE, SUSPENDED, FORCED_DEACTIVATION_WARNING	Review and update existing constant references, state branches, and persisted enum names. Do not handle this as a simple one-to-one rename
checkHvacFanSpeedCapabilities	Changed callback value type Map<SeatArea, List<Int>> -> Map<SeatArea, AreaBounds<Int>>	The previous List<Int> return contract is no longer maintained, so update list-based logic to min/max range handling
FanDirectionType	Expanded enum and changed order Expanded from 3 values to 8 values including UNKNOWN and composite airflow directions	Add handling for new states in exhaustive when branches. If ordinal values are persisted, migration is required: FACE 0 -> 1, FLOOR 1 -> 2, DEFROST 2 -> 4
DoorArea, MirrorArea, SeatArea, TurnSignalArea, WheelArea, WindowArea	Changed equality behavior Added value-based equals/hashCode so separate objects with the same ordered area values are treated as equal	Review Map/Set usage and equality logic that assumed each object instance would be treated as a unique key

Feature	Representative API	Details
Capability checks	checkVINInfoCapabilities checkSmartGlassLevelCapabilities, etc.	Check support status and access attributes for vehicle features
State read/subscribe	getCurrentEvEfficiency registerEvBatteryStateOfCharge getCurrentSmartGlassLevel, etc.	Read/subscribe EV/fuel efficiency, battery charge level, fuel level, ETCS voice guidance volume, and Smart Glass level
Vehicle info read	getVINInfo	Read VIN
SDK models	CapabilityConfig, TripStatistics, TelltaleData, Telltales	New models provided by Vehicle SDK

Target API	Change	Migration guidance
Existing Capability APIs including checkDoorLockCapabilities and checkWindowPositionCapabilities	Added overloads and deprecated previous callback forms New callbacks that also pass CapabilityConfig are provided	Using new overloads is recommended. WARNING-level deprecation does not mean the declaration is removed. checkHvacFanSpeedCapabilities also requires the Breaking change value type migration
registerHvacTemperature registerHvacTemperatureCurrent and matching unregister functions	Added overloads Added forms that take HvacTemperatureValueListener	Existing HvacTemperatureListener forms are still available, migrate as needed
EvBatteryLevelListener EvChargePortOpenListener RangeRemainingListener	Hidden from docs	Listener types and callback behavior are still maintained; this is different from API removal

Target API	Change	Migration guidance
getCRNInfo checkCRNInfoCapabilities	Deprecated	Move to getVINInfo and checkVINInfoCapabilities
checkWheelAreaCapabilities	Deprecated	Move to checkLowTirePressureCapabilities with CapabilityConfig and List<WheelArea>

Target API	Change	Required action
getHvacTemperatureValueSuggestion	Removed Method removed	Update code that uses this method
VehicleSpeedListener	Removed Listener and onSpeedUpdated removed	Update code that depends on this type/callback

Breaking change
- Changed navigation status callback parameter type and status values (onNavigationStatus: RouteDriving -> NavigationStatus)
- Changed coordinate parameter order in data model constructors (longitude, latitude -> latitude, longitude; BookmarkInfo, CurrentLocationInfo, DestinationInfo, RecentDestinationInfo, RequestWaypointInfo, RouteInfo, WaypointInfo)
- Changed destination/waypoint field names (DestinationInfo, WaypointInfo: totalDistance/totalTime -> remainDistance/remainTime)
New API
- Added route/screen request APIs (requestTrip, requestRouteWithWaypoints, requestNavigationScreen)
- Added initialization result callback support (initialize(onConnected, onFailed))
- Expanded navigation event listeners (onCautionPointInfo, onRoutingCompleted, onTripInfo)
Changed API
- Expanded navigation data model fields (POI provider, coordinates/distance, Trip/Traffic/Waypoint details)
- Added/changed constants and enums (CameraType, CautionPointType, NavigationStatus, RoutePointType)
Deprecated API
- Route-completion callback planned for deprecation (onRouteEnded -> use onRoutingCompleted)
Shutdown API
- Removed user-defined route result type/callback (FindRouteResult, onUserDefinedRoute)
- Split section speed camera enum values (remove CameraType.SPEED_CAMERA_SECTION -> SPEED_CAMERA_SECTION_START, SECTION_SPEED_ALERT, SPEED_CAMERA_SECTION_END)

Breaking change
- Changed error callback parameter type (String -> ErrorType)
New API
- Added initialization result callback support (TextToSpeech.initialize(listener: OnInitializeListener), OnInitializeListener)
- Added SDK version property (TextToSpeech.version)
- Added error type enum (ErrorType)
Changed API
- EventListener.onError(errMsg: String) -> EventListener.onError(errorType: ErrorType)
- OnServerConnectionListener.onFailed(msg: String) -> OnServerConnectionListener.onFailed(errorType: ErrorType)
Deprecated API
- None
Shutdown API
- Removed ai.pleos.playground.tts.constant.ServerType enum
- Removed public API exposure for ai.pleos.playground.tts.utils.Log and ai.pleos.playground.tts.utils.StringUtils

Breaking change
- Changed error callback parameter type (String -> ErrorType)
New API
- Added initialization result callback support (SpeechToText.initialize(listener: OnInitializeListener), OnInitializeListener)
- Added SDK version property (SpeechToText.version)
- Added error type enum (ErrorType)
- Added inference source enum (InferenceSource: ON_DEVICE, SERVER)
Changed API
- ResultListener.onError(errMsg: String) -> ResultListener.onError(errorType: ErrorType)
- OnServerConnectionListener.onFailed(msg: String) -> OnServerConnectionListener.onFailed(errorType: ErrorType)
Deprecated API
- None
Shutdown API
- Removed ai.pleos.playground.stt.api.DevelopmentOnly annotation
- Removed public API exposure for ai.pleos.playground.stt.utils.Log and ai.pleos.playground.stt.utils.StringUtils

Breaking change
- Changed location update callback parameter type (FusedLocationListener.onChanged: LocationData -> LocationData?)
- Added required error callback implementation (FusedLocationListener.onError(exception: Exception))
New API
- Added Proximity Alert feature group (addProximityAlert, removeProximityAlert)
- Added auxiliary read/support APIs (getLastKnownLocation, isSupported, showLocationAccessBlockedPopup)
- Added Proximity Alert Request/Event/Transition models and dedicated Listener
Changed API
- For FusedLocationListener callback changes, see the Breaking change section
Deprecated API
- None
Shutdown API
- None