API Connection

Aviso: para apps que usam a API CarConnection e segmentam o Android 14 (nível 34 da API) e versões mais recentes, use a versão 1.3.0-beta01 ou mais recente da biblioteca de apps para carros. Versões anteriores da biblioteca geram uma exceção em dispositivos com Android 14 ou mais recente devido à exigência de que receptores registrados pelo contexto especifiquem o comportamento de exportação.

Independente da versão da biblioteca Car App, para apps destinados ao Android 13 (nível 33 da API) ou versões anteriores, a API CarConnection não encontra esse problema, mesmo em um dispositivo com Android 14 ou mais recente.

Para determinar se o app está sendo executado no Android Auto ou no Android Automotive OS, use a API CarConnection para recuperar informações de conexão durante a execução. Exemplo:

1. No Session do app de carro, inicialize um CarConnection e inscreva-se nas atualizações de LiveData:

   Kotlin

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

   Java

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

2. No observador, reaja às mudanças no estado da conexão:

   Kotlin

   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();
   }