Car Hardware APIs

Начиная с уровня 3 Car App API, вы можете использовать Car App Library API для доступа к свойствам и датчикам автомобиля.

Требования

Чтобы использовать API с Android Auto, сначала добавьте зависимость от androidx.car.app:app-projected в файл build.gradle для модуля Android Auto. Для Android Automotive OS добавьте зависимость от androidx.car.app:app-automotive в файл build.gradle для модуля Android Automotive OS.

Кроме того, в файле AndroidManifest.xml необходимо объявить соответствующие разрешения, необходимые для запроса данных автомобиля, которые вы хотите использовать. Пользователь также должен предоставить вам эти разрешения. Вы можете использовать один и тот же код в Android Auto и Android Automotive OS, а не создавать потоки, зависящие от платформы. Однако необходимые разрешения различаются.

CarInfo

В таблице ниже описаны свойства, предоставляемые в API CarInfo, и разрешения, которые необходимо запросить для их использования.

Например, чтобы получить оставшийся диапазон, создайте объект CarInfo, а затем создайте и зарегистрируйте OnCarDataAvailableListener:

val carInfo = carContext.getCarService(CarHardwareManager::class.java).carInfo

val listener = OnCarDataAvailableListener<EnergyLevel> { data ->
    if (data.rangeRemainingMeters.status == CarValue.STATUS_SUCCESS) {
        val rangeRemaining = data.rangeRemainingMeters.value
    } else {
        // Handle error
    }
}

carInfo.addEnergyLevelListener(carContext.mainExecutor, listener)
// ...
// Unregister the listener when you no longer need updates
carInfo.removeEnergyLevelListener(listener)
CarHardware.kt

Не предполагайте, что данные автомобиля доступны всегда. Если вы получили сообщение об ошибке, проверьте статус запрошенного значения, чтобы понять, почему не удалось получить нужные данные. Подробнее о классе CarInfo можно узнать в справочной документации.

CarSensors

Класс CarSensors предоставляет доступ к акселерометру, гироскопу, компасу и данным о местоположении автомобиля. Доступность этих значений может зависеть от производителя устройства. Формат данных, полученных с помощью акселерометра, гироскопа и компаса, такой же, как и при использовании SensorManager API.

Например, чтобы проверить курс автомобиля:

val carSensors = carContext.getCarService(CarHardwareManager::class.java).carSensors

val listener = OnCarDataAvailableListener<Compass> { data ->
    if (data.orientations.status == CarValue.STATUS_SUCCESS) {
        val orientation = data.orientations.value
    } else {
        // Data not available, handle error
    }
}

carSensors.addCompassListener(CarSensors.UPDATE_RATE_NORMAL, carContext.mainExecutor, listener)
// ...
// Unregister the listener when you no longer need updates
carSensors.removeCompassListener(listener)
CarHardware.kt

Чтобы получить доступ к данным о местоположении автомобиля, необходимо также объявить и запросить разрешение android.permission.ACCESS_FINE_LOCATION.

Тест

Чтобы имитировать данные датчиков при тестировании в Android Auto, ознакомьтесь с разделами Датчики и Настройка датчиков в руководстве по использованию Desktop Head Unit. Чтобы имитировать данные датчиков при тестировании в Android Automotive OS, ознакомьтесь с разделом Эмуляция состояния оборудования в руководстве по эмулятору Android Automotive OS.