API подключения

Внимание: для приложений, использующих API CarConnection и ориентированных на Android 14 (уровень API 34) и выше, используйте библиотеку приложений Car версии 1.3.0-beta01 или более поздней. Более ранние версии библиотеки вызывают исключение на устройствах под управлением Android 14 или более поздней версии из-за необходимости указания поведения экспорта для контекстно-зарегистрированных приемников .

Независимо от версии библиотеки автомобильных приложений, для приложений, ориентированных на Android 13 (уровень API 33) или ниже, API CarConnection не сталкивается с этой проблемой, даже на устройствах с Android 14 или выше.

Чтобы определить, работает ли ваше приложение на Android Auto или Android Automotive OS, используйте API CarConnection для получения информации о подключении во время выполнения. Например:

1. В Session вашего автомобильного приложения инициализируйте CarConnection и подпишитесь на обновления LiveData :

   Котлин

   CarConnection(carContext).type.observe(this, ::onConnectionStateUpdated)
   

   Java

   new CarConnection(getCarContext()).getType().observe(this, this::onConnectionStateUpdated);
   

2. В наблюдателе реагируйте на изменения состояния соединения:

   Котлин

   fun onConnectionStateUpdated(connectionState: Int) {
     val message = when(connectionState) {
       CarConnection.CONNECTION_TYPE_NOT_CONNECTED -> "Not connected to a head unit"
       CarConnection.CONNECTION_TYPE_NATIVE -> "Connected to Android Automotive OS"
       CarConnection.CONNECTION_TYPE_PROJECTION -> "Connected to Android Auto"
       else -> "Unknown car connection type"
     }
     CarToast.makeText(carContext, message, CarToast.LENGTH_SHORT).show()
   }
   

   Java

   private void onConnectionStateUpdated(int connectionState) {
     String message;
     switch(connectionState) {
       case CarConnection.CONNECTION_TYPE_NOT_CONNECTED:
         message = "Not connected to a head unit";
         break;
       case CarConnection.CONNECTION_TYPE_NATIVE:
         message = "Connected to Android Automotive OS";
         break;
       case CarConnection.CONNECTION_TYPE_PROJECTION:
         message = "Connected to Android Auto";
         break;
       default:
         message = "Unknown car connection type";
         break;
     }
     CarToast.makeText(getCarContext(), message, CarToast.LENGTH_SHORT).show();
   }