API Connection

Avertissement : Pour les applications qui utilisent l'API CarConnection et ciblent Android 14 (niveau d'API 34) ou version ultérieure, utilisez la version 1.3.0-beta01 ou ultérieure de la bibliothèque Car App. Les versions antérieures de la bibliothèque génèrent une exception sur les appareils exécutant Android 14 ou version ultérieure en raison de l'obligation pour les récepteurs enregistrés en contexte de spécifier le comportement d'exportation.

Quelle que soit la version de la bibliothèque d'applications pour voitures, pour les applications qui ciblent Android 13 (niveau d'API 33) ou version antérieure, l'API CarConnection ne rencontre pas ce problème, même sur un appareil équipé d'Android 14 ou version ultérieure.

Pour déterminer si votre application s'exécute sur Android Auto ou Android Automotive OS, utilisez l'API CarConnection pour récupérer les informations de connexion au moment de l'exécution. Exemple :

1. Dans le Session de votre application pour voitures, initialisez un CarConnection et abonnez-vous aux mises à jour LiveData :

   Kotlin

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

   Java

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

2. Dans l'observateur, réagissez aux changements d'état de la connexion :

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