Bluetooth

Android fournit une implémentation Bluetooth complète compatible avec de nombreux profils Bluetooth courants dans les voitures. De nombreuses améliorations permettent également d'améliorer les performances et l'expérience avec d'autres appareils et services.

Gestion des connexions Bluetooth

Dans Android, CarBluetoothService gère les appareils Bluetooth et les listes de priorité de l'utilisateur actuel pour chaque connexion de profil à l'IVI. Les appareils sont connectés aux profils dans un ordre de priorité défini. Le moment où les appareils doivent être activés, désactivés et connectés à un profil est déterminé par une stratégie de connexion par défaut qui peut être ignorée à l'aide d'une superposition de ressources, si nécessaire.

Configurer la gestion des connexions automobiles

Désactiver la stratégie par défaut pour les téléphones

La pile Bluetooth Android gère une stratégie de connexion pour les téléphones, qui est activée par défaut. Cette règle doit être désactivée sur votre appareil afin qu'elle n'entre pas en conflit avec la règle automobile prévue dans CarBluetoothService. Bien que la superposition du produit Voiture s'en occupe pour vous, vous pouvez désactiver la règle du téléphone dans une superposition de ressources en définissant enable_phone_policy sur false dans MAXIMUM_CONNECTED_DEVICES dans /packages/apps/Bluetooth/res/values/config.xml.

Utiliser la stratégie par défaut pour le secteur automobile

CarBluetoothService gère les autorisations de profil par défaut. La liste des appareils connus et de leurs priorités de reconnexion de profil se trouve dans service/src/com/android/car/BluetoothProfileDeviceManager.java.

La règle de gestion des connexions Bluetooth se trouve également dans service/src/com/android/car/BluetoothDeviceConnectionPolicy.java. Par défaut, cette stratégie définit les cas où le Bluetooth doit se connecter et se déconnecter des appareils associés. Il gère également les cas spécifiques à la voiture pour déterminer quand l'adaptateur doit être activé et désactivé.

Créer votre propre règle de gestion des connexions automobiles personnalisée

Si la règle automobile par défaut ne répond pas à vos besoins, vous pouvez également la désactiver et utiliser votre propre règle personnalisée. Votre règle personnalisée doit au moins déterminer quand activer et désactiver l'adaptateur Bluetooth, ainsi que quand connecter des appareils. Vous pouvez utiliser différents événements pour activer/désactiver l'adaptateur Bluetooth et pour établir des connexions d'appareils, y compris des événements dus à des modifications de propriétés de voiture spécifiques.

Désactiver la règle par défaut pour les véhicules

Tout d'abord, pour utiliser une règle personnalisée, la règle automobile par défaut doit être désactivée en définissant useDefaultBluetoothConnectionPolicy sur false dans une superposition de ressources. Cette ressource est initialement définie comme faisant partie de MAXIMUM_CONNECTED_DEVICES dans packages/services/Car/service/res/values/config.xml.

Activer et désactiver l'adaptateur Bluetooth

L'une des fonctions principales de votre stratégie consiste à activer et à désactiver l'adaptateur Bluetooth aux moments appropriés. Vous pouvez utiliser les API de framework BluetoothAdapter.enable() et BluetoothAdapter.disable() pour activer et désactiver l'adaptateur. Ces appels doivent respecter l'état persistant que l'utilisateur a sélectionné dans les paramètres ou par tout autre moyen. Pour ce faire, procédez comme suit:

/**
 * Turn on the Bluetooth adapter.
 */
private void enableBluetooth() {
    BluetoothAdapter bluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
    if (bluetoothAdapter == null) {
        return;
    }
    bluetoothAdapter.enable();
}

/**
 * Turn off the Bluetooth adapter.
 */
private void disableBluetooth() {
    BluetoothAdapter bluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
    if (bluetoothAdapter == null) {
        return;
    }
    // Will shut down _without_ persisting the off state as the desired state
    // of the Bluetooth adapter for next start up. This does nothing if the adapter
    // is already off, keeping the existing saved desired state for next reboot.
    bluetoothAdapter.disable(false);
}

Déterminer quand activer et désactiver l'adaptateur Bluetooth

Avec votre règle personnalisée, vous êtes libre de déterminer les événements qui indiquent les meilleurs moments pour activer et désactiver l'adaptateur. Pour ce faire, vous pouvez utiliser les états d'alimentation MAXIMUM_CONNECTED_DEVICES dans CarPowerManager:

private final CarPowerStateListenerWithCompletion mCarPowerStateListener =
        new CarPowerStateListenerWithCompletion() {
    @Override
    public void onStateChanged(int state, CompletableFuture<Void> future) {
        if (state == CarPowerManager.CarPowerStateListener.ON) {
            if (isBluetoothPersistedOn()) {
                enableBluetooth();
            }
            return;
        }

        // "Shutdown Prepare" is when the user perceives the car as off
        // This is a good time to turn off Bluetooth
        if (state == CarPowerManager.CarPowerStateListener.SHUTDOWN_PREPARE) {
            disableBluetooth();

            // Let CarPowerManagerService know we're ready to shut down
            if (future != null) {
                future.complete(null);
            }
            return;
        }
    }
};

Déterminer quand connecter des appareils

De même, lorsque vous déterminez les événements qui doivent déclencher le début des connexions d'appareils, CarBluetoothManager fournit l'appel d'API connectDevices() qui procède à la connexion des appareils en fonction des listes de priorité définies pour chaque profil Bluetooth.

Par exemple, vous pouvez le faire chaque fois que l'adaptateur Bluetooth s'allume:

private class BluetoothBroadcastReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);
        if (BluetoothAdapter.ACTION_STATE_CHANGED.equals(action)) {
            int state = intent.getIntExtra(BluetoothAdapter.EXTRA_STATE, -1);
            if (state == BluetoothAdapter.STATE_ON) {
                // mContext should be your app's context
                Car car = Car.createCar(mContext);
                CarBluetoothManager carBluetoothManager =
                        (CarBluetoothManager) car.getCarManager(Car.BLUETOOTH_SERVICE);
                carBluetoothManager.connectDevices();
            }
        }
    }
}

Vérifier la gestion des connexions automobiles

Le moyen le plus simple de vérifier le comportement de votre stratégie de connexion consiste à activer le Bluetooth sur votre IVI et à vérifier qu'il se connecte automatiquement aux bons appareils dans l'ordre approprié. Vous pouvez activer ou désactiver l'adaptateur Bluetooth via l'interface utilisateur des paramètres ou à l'aide des commandes adb suivantes:

adb shell su u$(adb shell am get-current-user)_system svc bluetooth disable

adb shell su u$(adb shell am get-current-user)_system svc bluetooth enable

En outre, vous pouvez utiliser le résultat de la commande suivante pour afficher des informations de débogage liées aux connexions Bluetooth:

adb shell dumpsys car_service

Enfin, si vous avez créé votre propre règle pour les véhicules automobiles, la validation de tout comportement de connexion personnalisé nécessite de contrôler les événements que vous avez choisis pour déclencher les connexions des appareils.

Profils Bluetooth pour l'automobile

Sous Android, l'IVI peut prendre en charge plusieurs appareils connectés simultanément via Bluetooth. Les services téléphoniques Bluetooth multi-appareils permettent aux utilisateurs de connecter simultanément des appareils distincts, tels qu'un téléphone personnel et un téléphone professionnel, et de passer des appels mains libres depuis l'un ou l'autre.

Les limites de connexion sont appliquées par chaque profil Bluetooth, généralement dans l'implémentation du service de profil lui-même. Par défaut, CarBluetoothService n'effectue aucune autre évaluation du nombre maximal d'appareils connectés autorisés.

Profil mains libres

Le profil mains libres Bluetooth (HFP) permet au véhicule de passer et de recevoir des appels téléphoniques via un appareil à distance connecté. Chaque connexion d'appareil enregistre un compte de téléphone distinct auprès de TelecomManager, qui annonce tous les comptes de téléphone disponibles aux applications IVI.

L'IVI peut se connecter à plusieurs appareils via HFP. MAX_STATE_MACHINES_POSSIBLE MAXIMUM_CONNECTED_DEVICES dans HeadsetClientService définit le nombre maximal de connexions HFP simultanées.

Lorsqu'un utilisateur passe ou reçoit un appel téléphonique depuis un appareil, le compte téléphonique correspondant crée un objet HfpClientConnection. L'application Téléphone interagit avec l'objet HfpClientConnection pour gérer les fonctionnalités d'appel, telles que l'acceptation d'un appel ou la fin de l'appel.

Notez que l'application Téléphone par défaut n'est pas compatible avec plusieurs appareils HFP connectés simultanément. Pour implémenter le HFP multi-appareil, une personnalisation est requise pour permettre aux utilisateurs de sélectionner le compte d'appareil à utiliser lors d'un appel. L'application appelle ensuite telecomManager.placeCall avec le bon compte. Vous devez également vérifier que les autres fonctionnalités multi-appareils fonctionnent comme prévu.

Remarque:Les connexions SCO (Synchronous Connection Oriented) HFP et le routage audio des appels téléphoniques doivent être effectués manuellement avec connectAudio dans le liaison d'application.

Vérifier la compatibilité HFP multi-appareils

Pour vérifier que la connectivité multi-appareil fonctionne correctement via Bluetooth:

1. Connectez un appareil à l'IVI via Bluetooth et diffusez du contenu audio depuis l'appareil.
2. Connectez deux téléphones à l'IVI via le Bluetooth.
3. Choisissez un téléphone. Passer un appel sortant directement depuis le téléphone et passer un appel sortant à l'aide de l'IVI
   1. À chaque fois, vérifiez que l'audio en streaming est mis en pause et que l'audio du téléphone est diffusé sur les haut-parleurs connectés à l'IVI.
4. Sur le même téléphone, recevez un appel entrant directement sur le téléphone et recevez un appel entrant à l'aide de l'IVI.
   1. À chaque fois, vérifiez que le streaming audio est mis en pause et que l'audio du téléphone est diffusé sur les haut-parleurs connectés à l'IVI.
5. Répétez les étapes 3 et 4 avec l'autre téléphone connecté.

Appels d'urgence

La possibilité de passer des appels d'urgence est un aspect important des fonctions de téléphonie et de Bluetooth dans la voiture. Vous pouvez lancer un appel d'urgence de plusieurs façons depuis l'IVI, par exemple:

• Solution eCall autonome
• Solution eCall intégrée à l'IVI
• S'appuyer sur un téléphone Bluetooth connecté lorsqu'aucun système intégré n'est disponible

Établir un appel d'urgence

Bien que l'équipement eCall soit essentiel à la sécurité, il n'est actuellement pas intégré à Android. Vous pouvez utiliser ConnectionService pour exposer les fonctionnalités d'appel d'urgence via Android, ce qui présente également l'avantage d'introduire des options d'accessibilité pour les appels d'urgence. Pour en savoir plus, consultez la section Créer une application d'appel.

Voici un exemple d'établissement d'un ConnectionService d'urgence:

public class YourEmergencyConnectionService extends ConnectionService {

    @Override
    public Connection onCreateOutgoingConnection(
            PhoneAccountHandle connectionManagerAccount,
            ConnectionRequest request) {
        // Your equipment specific procedure to make ecall
        // ...
    }

    private void onYourEcallEquipmentReady() {

        PhoneAccountHandle handle =
            new PhoneAccountHandle(new ComponentName(context, YourEmergencyConnectionService),
                    YourEmergencyConnectionId);
        PhoneAccount account =
            new PhoneAccount.Builder(handle, eCallOnlyAccount)
            .setSupportedUriSchemes(Arrays.asList(PhoneAccount.SCHEME_TEL))
            .setCapabilities(PhoneAccount.CAPABILITY_PLACE_EMERGENCY_CALLS
                    | PhoneAccount.CAPABILITY_MULTI_USER)
            .build():
        mTelecomManager.registerPhoneAccount(account);
        mTelecomManager.enablePhoneAccount(account.getAccountHandle(), true);
    }
}

Activer le Bluetooth pour les appels d'urgence

Avant Android 10, l'appel d'urgence impliquait de composer directement un numéro de téléphone et d'invoquer un équipement spécial, le cas échéant (par exemple, un déclenchement automatique en cas de danger ou d'action de l'utilisateur). Sous Android 10 et versions ultérieures, le clavier de l'application Téléphone dans la voiture peut appeler directement un numéro d'urgence, à condition que cette MAXIMUM_CONNECTED_DEVICES soit définie dans apps/Bluetooth/res/values/config.xml:

<!-- For supporting emergency call through the hfp client connection service --> <bool name=”hfp_client_connection_service_support_emergency_call”>true</bool>

En implémentant les appels d'urgence de cette manière, d'autres applications, telles que la reconnaissance vocale, peuvent également appeler un numéro d'urgence.

Remarque:Le Bluetooth n'a pas été conçu spécifiquement pour les appels d'urgence. Par conséquent, cette option ne doit être envisagée que pour les voitures sans équipement eCall spécial.

Profil d'accès au répertoire téléphonique

Le profil d'accès au répertoire téléphonique Bluetooth (PBAP) télécharge les contacts et les historiques des appels à partir d'un appareil distant connecté. PBAP gère une liste de contacts agrégée et consultable qui est mise à jour par la machine d'état du client PBAP. Chaque appareil connecté interagit avec une machine d'état client PBAP distincte, ce qui permet d'associer les contacts à l'appareil approprié lors d'un appel.

PBAP est unidirectionnel et nécessite donc que l'IVI instancie des connexions à n'importe quel MAXIMUM_CONNECTED_DEVICES dans PbapClientService définit le nombre maximal de connexions d'appareils PBAP simultanées autorisées avec l'IVI. Le client PBAP stocke les contacts de chaque appareil connecté dans le fournisseur de contacts, auquel une application peut ensuite accéder pour dériver le carnet d'adresses de chaque appareil.

De plus, la connexion de profil doit être autorisée à la fois par l'IVI et l'appareil mobile pour qu'une connexion soit établie. Lorsqu'un client PBAP se déconnecte, la base de données interne supprime tous les contacts et l'historique des appels associés à l'appareil précédemment connecté.

Profil d'accès aux messages

Le profil d'accès aux messages (MAP) Bluetooth permet au véhicule d'envoyer et de recevoir des SMS via un appareil à distance connecté. Actuellement, les messages ne sont pas stockés localement sur l'IVI. Au lieu de cela, chaque fois que l'appareil distant connecté reçoit un message, l'IVI le reçoit et l'analyse, puis diffuse son contenu dans une instance d'intent, qui peut ensuite être reçue par une application.

Pour se connecter à un appareil mobile afin d'envoyer et de recevoir des messages, l'IVI doit établir la connexion MAP. MAXIMUM_CONNECTED_DEVICES dans MapClientService définit le nombre maximal de connexions d'appareils MAP simultanées autorisées avec l'IVI. Chaque connexion doit être autorisée par l'IVI et l'appareil mobile avant que les messages puissent être transférés.

Advanced Audio Distribution Profile (A2DP)

Le profil de distribution audio avancé (A2DP) du Bluetooth permet au véhicule de recevoir des flux audio à partir d'un appareil à distance connecté.

Contrairement aux autres profils, le nombre maximal d'appareils A2DP connectés est appliqué dans la pile native et non dans Java. La valeur est actuellement codée en dur sur 1 à l'aide de la variable kDefaultMaxConnectedAudioDevices dans packages/modules/Bluetooth/system/btif/src/btif_av.cc.

Audio/Video Remote Control Profile (AVRCP)

Le profil Bluetooth Audio/Video Remote Control Profile (AVRCP) permet au véhicule de contrôler et de parcourir les lecteurs multimédias sur un appareil distant connecté. Étant donné que l'IVI joue le rôle de contrôleur AVRCP, toutes les commandes déclenchées qui affectent la lecture audio reposent sur une connexion A2DP à l'appareil cible.

Pour qu'un lecteur multimédia spécifique sur un téléphone Android puisse être parcouru par l'IVI via AVRCP, l'application multimédia du téléphone doit fournir un MediaBrowserService et autoriser com.android.bluetooth à accéder à ce service. Créer un service de navigateur multimédia explique comment procéder en détail.