Introduction
Overview
The Vehicle SDK provides APIs for retrieving and controlling vehicle information. Third-party apps connect to the Vehicle Service in Pleos Connect through the Vehicle SDK. The Vehicle Service runs on Android Automotive OS; third-party apps request vehicle information retrieval and control via Vehicle SDK APIs, and the Vehicle Service handles those requests.
Entry point and domain structure
Vehicle SDK APIs are provided as domain interfaces such as Brake, CarInfo, Display, Door, DrivingMode, EvBattery, Fuel, HVAC, and Light. Domain objects such as Door and Brake are not created directly; obtain them only via getXxx() methods on an instance of Vehicle, the Vehicle SDK entry point—for example getDoor() and getBrake(). On the domain object, call capability, get, set, and callback APIs. Capability (checkXXXCapabilities) checks feature support and allowed value ranges; get reads the current value; set writes a value. Callback registers listeners to subscribe to state changes.
Connect to the vehicle service with initialize(), and call release() when finished. Because vehicle communication uses IPC, capability, get, and set results are not returned synchronously; they are delivered via asynchronous onComplete and onFailed lambdas. Do not call release() before async callbacks complete.
| Domain | Description |
|---|---|
| Brake | Query brake pedal and parking brake status |
| CarInfo | Query basic vehicle information (dimensions, manufacturer, model year, etc.) |
| Display | Query/set infotainment display data units (e.g., temperature unit) |
| Door | Control and query door open/close, lock/unlock, and status |
| DrivingMode | Query drive mode and cruise control information |
| EvBattery | Query EV battery and charging status, and efficiency (EV economy) |
| Fuel | Query fuel-related information such as fuel economy |
| HVAC | Control and query heating, ventilation, and A/C (temperature, airflow, humidity, etc.) |
| Light | Query lighting status and control ambient lights, etc. |
| Odometer | Query total distance, trip distance/time, and distance unit |
| Safety | Query vehicle warning information |
| Seat | Control and query seat position, angle, and functions |
| SideMirror | Query/set side mirror heating status |
| Steeringwheel | Query steering wheel status and heating; control heating |
| Tire | Query tire status |
| Toll | Query/set ETCS (hi-pass) voice guidance volume, etc. |
| TurnSignal | Query turn signal status |
| Window | Control and query window status |
| Wiper | Control and query wiper status |
Emulator setup
Develop and verify the Vehicle SDK in the Pleos Connect Emulator environment. Prepare your development environment in the following order.
- Check development environment requirements
- Install the Pleos Connect Emulator
- Create and run an AVD
- Configure microphone access
- Configure cold boot
- Connect a Bluetooth dongle to the AVD
Related information
| Document | Description |
|---|---|
| Obtaining a domain object | How to obtain domain objects and call Get, Set, Callback, and Capability APIs |
| Permission | Permissions by domain |
| Error code | Error codes and onFailed handling |
| API Reference | Vehicle SDK API reference |
| Tutorial | Vehicle SDK implementation guide |
| Sample Project | Sample project |