# 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)

*** ** * ** ***


```
public final class EnergyLevel.Builder
```

<br />

*** ** * ** ***

A builder of `https://developer.android.com/reference/androidx/car/app/hardware/info/EnergyLevel`.

## Summary

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

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

## Public constructors

### Builder

Added in 1.1.0

```
public Builder()
```

## Public methods

### build

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

```
public @NonNull EnergyLevel build()
```

Constructs the `https://developer.android.com/reference/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)

```
public @NonNull EnergyLevel.Builder setBatteryPercent(@NonNull CarValue<Float> batteryPercent)
```

Sets the remaining batter percentage.

### setDistanceDisplayUnit

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

```
public @NonNull EnergyLevel.Builder setDistanceDisplayUnit(@NonNull CarValue<Integer> distanceDisplayUnit)
```

Sets the distance display unit.

Valid values are in `https://developer.android.com/reference/androidx/car/app/hardware/common/CarUnit`.

| Throws |
|---|---|
| `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)

```
public @NonNull EnergyLevel.Builder setEnergyIsLow(@NonNull CarValue<Boolean> energyIsLow)
```

Sets if the remaining energy is low.

| Throws |
|---|---|
| `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)

```
public @NonNull EnergyLevel.Builder setFuelPercent(@NonNull CarValue<Float> fuelPercent)
```

Sets the remaining fuel percentage.

| Throws |
|---|---|
| `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
public @NonNull EnergyLevel.Builder setFuelVolumeDisplayUnit(
    @NonNull CarValue<Integer> fuelVolumeDisplayUnit
)
```

Sets the fuel volume display unit.

| Throws |
|---|---|
| `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)

```
public @NonNull EnergyLevel.Builder setRangeRemainingMeters(@NonNull CarValue<Float> rangeRemainingMeters)
```

Sets the range of the remaining fuel in meters.

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