# EnergyLevel.Builder

# EnergyLevel.Builder

Artifact:[androidx.car.app:app](https://developer.android.com/jetpack/androidx/releases/car-app)  
[View Source](https://cs.android.com/search?q=file:androidx/car/app/hardware/info/EnergyLevel.java+class:androidx.car.app.hardware.info.EnergyLevel.Builder)  
Added in[1.1.0](https://developer.android.com/jetpack/androidx/releases/car-app#1.1.0)

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/car/app/hardware/info/EnergyLevel.Builder "View this page in Java")

<br />

```
class EnergyLevel.Builder
```

<br />

*** ** * ** ***

A builder of[EnergyLevel](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel).

## Summary

|                                                  ### Public constructors                                                   |
|----------------------------------------------------------------------------------------------------------------------------|
| [Builder](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel.Builder#Builder())`()` |

|                                                   ### Public functions                                                   |
|--------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [EnergyLevel](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel)                 | [build](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel.Builder#build())`()` Constructs the[EnergyLevel](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel)defined by this builder.                                                                                                                                                                                                                                                                                                                            |
| [EnergyLevel.Builder](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel.Builder) | [setBatteryPercent](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel.Builder#setBatteryPercent(androidx.car.app.hardware.common.CarValue<java.lang.Float>))`(batteryPercent: `[CarValue](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/common/CarValue)`<`[Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html)`!>)` Sets the remaining batter percentage.                                                                                                                                         |
| [EnergyLevel.Builder](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel.Builder) | [setDistanceDisplayUnit](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel.Builder#setDistanceDisplayUnit(androidx.car.app.hardware.common.CarValue<java.lang.Integer>))`(distanceDisplayUnit: `[CarValue](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/common/CarValue)`<`[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`!>)` Sets the distance display unit.                                                                                                                                  |
| [EnergyLevel.Builder](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel.Builder) | [setEnergyIsLow](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel.Builder#setEnergyIsLow(androidx.car.app.hardware.common.CarValue<java.lang.Boolean>))`(energyIsLow: `[CarValue](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/common/CarValue)`<`[Boolean](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`!>)` Sets if the remaining energy is low.                                                                                                                                             |
| [EnergyLevel.Builder](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel.Builder) | [setFuelPercent](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel.Builder#setFuelPercent(androidx.car.app.hardware.common.CarValue<java.lang.Float>))`(fuelPercent: `[CarValue](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/common/CarValue)`<`[Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html)`!>)` Sets the remaining fuel percentage.                                                                                                                                                    |
| [EnergyLevel.Builder](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel.Builder) | `@`[ExperimentalCarApi](https://developer.android.com/reference/kotlin/androidx/car/app/annotations/ExperimentalCarApi) [setFuelVolumeDisplayUnit](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel.Builder#setFuelVolumeDisplayUnit(androidx.car.app.hardware.common.CarValue<java.lang.Integer>))`(fuelVolumeDisplayUnit: `[CarValue](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/common/CarValue)`<`[Int](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`!>)` Sets the fuel volume display unit. |
| [EnergyLevel.Builder](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel.Builder) | [setRangeRemainingMeters](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel.Builder#setRangeRemainingMeters(androidx.car.app.hardware.common.CarValue<java.lang.Float>))`(rangeRemainingMeters: `[CarValue](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/common/CarValue)`<`[Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html)`!>)` Sets the range of the remaining fuel in meters.                                                                                                             |

## Public constructors

### Builder

Added in 1.1.0  

```
Builder()
```  

## Public functions

### build

Added in[1.1.0](https://developer.android.com/jetpack/androidx/releases/car-app#1.1.0)  

```
fun build(): EnergyLevel
```

Constructs the[EnergyLevel](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/info/EnergyLevel)defined by this builder.  

### setBatteryPercent

Added in[1.1.0](https://developer.android.com/jetpack/androidx/releases/car-app#1.1.0)  

```
fun setBatteryPercent(batteryPercent: CarValue<Float!>): EnergyLevel.Builder
```

Sets the remaining batter percentage.  

### setDistanceDisplayUnit

Added in[1.1.0](https://developer.android.com/jetpack/androidx/releases/car-app#1.1.0)  

```
fun setDistanceDisplayUnit(distanceDisplayUnit: CarValue<Int!>): EnergyLevel.Builder
```

Sets the distance display unit.

Valid values are in[CarUnit](https://developer.android.com/reference/kotlin/androidx/car/app/hardware/common/CarUnit).  

|                                                    Throws                                                     |
|---------------------------------------------------------------------------------------------------------------|---------------------------------|
| [java.lang.NullPointerException](https://developer.android.com/reference/java/lang/NullPointerException.html) | if`distanceDisplayUnit`is`null` |

### setEnergyIsLow

Added in[1.1.0](https://developer.android.com/jetpack/androidx/releases/car-app#1.1.0)  

```
fun setEnergyIsLow(energyIsLow: CarValue<Boolean!>): EnergyLevel.Builder
```

Sets if the remaining energy is low.  

|                                                    Throws                                                     |
|---------------------------------------------------------------------------------------------------------------|-------------------------|
| [java.lang.NullPointerException](https://developer.android.com/reference/java/lang/NullPointerException.html) | if`energyIsLow`is`null` |

### setFuelPercent

Added in[1.1.0](https://developer.android.com/jetpack/androidx/releases/car-app#1.1.0)  

```
fun setFuelPercent(fuelPercent: CarValue<Float!>): EnergyLevel.Builder
```

Sets the remaining fuel percentage.  

|                                                    Throws                                                     |
|---------------------------------------------------------------------------------------------------------------|-------------------------|
| [java.lang.NullPointerException](https://developer.android.com/reference/java/lang/NullPointerException.html) | if`fuelPercent`is`null` |

### setFuelVolumeDisplayUnit

Added in[1.1.0](https://developer.android.com/jetpack/androidx/releases/car-app#1.1.0)  

```
@ExperimentalCarApi
fun setFuelVolumeDisplayUnit(fuelVolumeDisplayUnit: CarValue<Int!>): EnergyLevel.Builder
```

Sets the fuel volume display unit.  

|                                                    Throws                                                     |
|---------------------------------------------------------------------------------------------------------------|-----------------------------------|
| [java.lang.NullPointerException](https://developer.android.com/reference/java/lang/NullPointerException.html) | if`fuelVolumeDisplayUnit`is`null` |

### setRangeRemainingMeters

Added in[1.1.0](https://developer.android.com/jetpack/androidx/releases/car-app#1.1.0)  

```
fun setRangeRemainingMeters(rangeRemainingMeters: CarValue<Float!>): EnergyLevel.Builder
```

Sets the range of the remaining fuel in meters.  

|                                                    Throws                                                     |
|---------------------------------------------------------------------------------------------------------------|----------------------------|
| [java.lang.NullPointerException](https://developer.android.com/reference/java/lang/NullPointerException.html) | if`rangeRemaining`is`null` |