Declaring permission

Vehicle SDK API requires Pleos vehicle permissions to be declared in the Android manifest. Refer to the @RequiresPermission annotation and constant definitions in PleosPermission.

Permission types

PleosPermission constants are distinguished by prefixes. Declare each permission in the manifest using the pleos.car.permission.{CONSTANT_NAME} format.

Prefix	Example	Purpose
CAR_*	CAR_DOORS → pleos.car.permission.CAR_DOORS	Retrieve domain data (get)
CONTROL_CAR_*	CONTROL_CAR_DOORS	Control a domain (set)

Representative permissions by domain (CAR_*)

These are typical read permissions per domain. Each API may require a different permission—check @RequiresPermission before calling.

Domain	Constant	Manifest value
Door	CAR_DOORS	pleos.car.permission.CAR_DOORS
Window, Wiper	CAR_WINDOWS	pleos.car.permission.CAR_WINDOWS
HVAC	CAR_CLIMATE	pleos.car.permission.CAR_CLIMATE
DrivingMode, Brake, Odometer	CAR_DRIVE	pleos.car.permission.CAR_DRIVE
EvBattery, Fuel	CAR_ENERGY	pleos.car.permission.CAR_ENERGY
CarInfo, Display	CAR_INFO	pleos.car.permission.CAR_INFO
Light, TurnSignal	CAR_LIGHTS	pleos.car.permission.CAR_LIGHTS
SideMirror	CAR_MIRRORS	pleos.car.permission.CAR_MIRRORS
Safety, Tire	CAR_SAFETY	pleos.car.permission.CAR_SAFETY
Seat	CAR_SEATS	pleos.car.permission.CAR_SEATS
Toll	CAR_TOLL	pleos.car.permission.CAR_TOLL

Permission declaration example

Declare only permissions for domains you use. For dependencies, see Importing Vehicle SDK.

AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">

    <uses-permission android:name="pleos.car.permission.CAR_DOORS" />
    <uses-permission android:name="pleos.car.permission.CAR_INFO" />

    <!-- Declare only the permissions for domains you use -->

</manifest>

Missing permissions

When a required permission is missing, the API passes an Exception to onFailed. If the exception is a VehicleException, it can correspond to ERROR_SECURITY_PERMISSION. For handling instructions, see Error code.