Car Messenger

Car Messenger propose des fonctionnalités de messagerie conçues pour les appareils automobiles. Comme les autres applications pour voitures, les utilisateurs lancent Car Messenger à partir du lanceur.

Nouveautés de Car Messenger

Avec la nouvelle application Car Messenger, les conducteurs peuvent:

• Bénéficiez d'une expérience de messagerie dédiée.
• Lancez Car Messenger depuis le lanceur d'applications.
• Parcourir les messages reçus avant et pendant un trajet
• Écoutez vos messages et répondez-y.
• Couper le son des notifications de messages
• Lancez de nouvelles conversations.

Terminologie

Les termes suivants sont utilisés sur cette page:

Avantages des applications dégroupées

Les applications non groupées, comme Car Messenger, présentent les avantages suivants:

• Utilise uniquement des méthodes publiques (aucune dépendance de plate-forme sur les API masquées)
• Développer des applications en dehors de la plate-forme Android
• Activer les versions plus fréquentes (pour les nouvelles fonctionnalités et les problèmes résolus)
• Mettre à jour des applications via Google Play

En savoir plus sur les applications non groupées

Détails techniques

Cette section décrit l'architecture de Car Messenger. Pour en savoir plus, consultez la section Intégrer à CarVoiceInteractionSession.

Architecture basée sur la téléphonie

Lors de l'association via Bluetooth, les données sont synchronisées entre la base de données de téléphonie du téléphone et la base de données de téléphonie de la voiture. Lors de la déconnexion du Bluetooth, les données synchronisées sont supprimées de la base de données téléphonique de la voiture.

Cette fonctionnalité a été introduite dans Android 12. Voici les principaux avantages:

• Les messages d'utilisateurs peuvent être récupérés de manière groupée à partir d'une base de données.
• Les messages de trajets précédents sont acceptés.
• Utilise une architecture et une API similaires pour le stockage et la récupération de SMS sur les téléphones Android.
• Il est entièrement dissocié de la plate-forme Android.

Voici le processus:

Figure 1. Flux de données basé sur la téléphonie.

Flux illustré au format texte:

 1. Phone connects to car.
    |
    --> 2. SMS data transferred from phone's database to car database.
          |
          --> 3. Car Messenger retrieves data from telephony database to display on UI.
                  |
                  --> 4. User interactions prompt the voice assistant.
                  |
          <-- 5. Car Messenger receives reply action from the voice assistant.
          |
    <-- 6. SMS is marked as read in car database.
    |
 7. Reply transmitted to recipients, phone database updated with reply and read status.

Voici ce que nous faisons avec ces données:

Figure 2. Traitement des données Car Messenger

Flux illustré au format texte:

 1. Phone connects to car.
    |
    --> 2. SMS data transferred from phone's database to car database.
          |
          --> 3. Phone disconnects from car.
                  |
                  --> 4. SMS data deleted from car telephony database.

• Lors de la connexion, les données sont transférées du téléphone vers la voiture à l'aide du profil MAP (Message Access Profile) du Bluetooth.
• Lorsque vous vous déconnectez, les données de ce téléphone sont supprimées de la base de données de la voiture.

Obtenir Car Messenger

Obtenez le dernier commit Car Messenger de Google Git.

API d'interaction vocale

Car Messenger utilise les API CarVoiceInteractionSession pour s'intégrer à l'assistant. Ces éléments sont décrits dans les sections suivantes.

Modèle PendingIntent

Ces API utilisent PendingIntent pour transmettre les requêtes d'assistant résolues en retour à Car Messenger.

Voici la séquence d'événements:

1. Car Messenger lance l'Assistant en appelant activity.showAssist(Bundle args). Les arguments contiennent l'action de l'API et ses paramètres obligatoires, contenant un intent en attente si nécessaire.

2. L'Assistant récupère l'entrée utilisateur si nécessaire et la regroupe avec l'intent en attente.

3. L'Assistant renvoie l'intent à Car Messenger.

4. Car Messenger résout l'action de l'API.

Action d'API "Marquer comme lu"

Lorsque l'Assistant lit un message, PendingIntent est envoyé à Car Messenger avec l'action VOICE_ACTION_READ_NOTIFICATION ou VOICE_ACTION_READ_CONVERSATION pour marquer le message comme lu.

Action de l'API Direct Reply

Lorsque l'Assistant répond à un message, PendingIntent est envoyé à Car Messenger avec l'action VOICE_ACTION_REPLY_NOTIFICATION et VOICE_ACTION_REPLY_CONVERSATION pour répondre à la conversation.

Action de l'API Direct Send SMS

Un lot avec l'action VOICE_ACTION_SEND_SMS est envoyé de Car Messenger à l'assistant.

Exemple de code:

/**
 *   KEY_PHONE_NUMBER - Recipient’s phone number. If this and the recipients name are not
 *   provided by the application, assistant must do contact disambiguation but is not required
 *   to add the name to the PendingIntent.
 *
 *   KEY_RECIPIENT_NAME - Recipient’s name. If this and the recipient phone number are not
 *   provided by the application, assistant must do contact disambiguation but is not required
 *   to add the name to the PendingIntent.
 *
 *   KEY_RECIPIENT_UID - Recipient’s UID in the ContactProvider database. Optionally provided
 *   by the application. Not required to be sent back by the assistant.
 *
 *   KEY_DEVICE_NAME - Friendly name of the device in which to send the message from. If not
 *   provided by the application, assistant must do device disambiguation but is not required
 *   to add it to PendingIntent. In V1 this is required to be sent by the application.
 *
 *   KEY_DEVICE_ADDRESS - Bluetooth device address of the device in which to send the message
 *   from. If not provided by the application, assistant must do device disambiguation and add
 *   this to the PendingIntent. In V1 this is required to be sent by the application.
 *
 *   KEY_SEND_PENDING_INTENT - @NotNull Will always be provided by the application. The
 *   application must preload the pending intent with any KEYs it provides the assistant that
 *   is also needed to send the message. (I.e if the application passes in the
 *   KEY_PHONE_NUMBER in the Bundle, the assistant can assume the application has already put
 *   this in the PendingIntent and may not re-add it to the PendingIntent).
 *
 */
public static final String KEY_PHONE_NUMBER = “KEY_PHONE_NUMBER”;
public static final String KEY_RECIPIENT_NAME = “KEY_RECIPIENT_NAME”;
public static final String KEY_RECIPIENT_UID = “KEY_RECIPIENT_UID”;
public static final String KEY_DEVICE_NAME = “KEY_DEVICE_NAME”;
public static final String KEY_DEVICE_ADDRESS = “KEY_DEVICE_NAME”;
public static final String KEY_SEND_PENDING_INTENT =”KEY_SEND_PENDING_INTENT”;

Cette image montre la composition d'un message lorsqu'un destinataire est sélectionné:

Figure 3 : Page Contacts dans l'application Téléphone.

Cette image montre comment rédiger un message sans sélectionner de destinataire à l'aide de Nouveau message:

Figure 4. Bouton "Nouveau message" dans l'application Messenger.

Intégrer l'action d'envoi direct de SMS

Voici un exemple d'intégration de VOICE_ACTION_SEND_SMS par l'application Téléphone, en fournissant les paramètres facultatifs:

    /**
     * Build the {@link Bundle} to pass to assistant to send a sms.
     */
    public Bundle buildDirectSendBundle(String number, String name, String uid,
                                        BluetoothDevice device) {
        Bundle bundle = new Bundle();
        bundle.putString(CarVoiceInteractionSession.KEY_ACTION, VOICE_ACTION_SEND_SMS);
        // start optional parameters
        bundle.putString(CarVoiceInteractionSession.KEY_PHONE_NUMBER, number);
        bundle.putString(CarVoiceInteractionSession.KEY_RECIPIENT_NAME, name);
        bundle.putString(CarVoiceInteractionSession.KEY_RECIPIENT_UID, uid);
        // end optional parameters
        bundle.putString(CarVoiceInteractionSession.KEY_DEVICE_ADDRESS, device.getAddress());
        bundle.putString(CarVoiceInteractionSession.KEY_DEVICE_NAME,
                DialerUtils.getDeviceName(mContext, device));
        Intent intent = new Intent(mContext, MessagingService.class)
                .setAction(ACTION_DIRECT_SEND)
                .setClass(mContext, MessagingService.class);

        int requestCode = ACTION_DIRECT_SEND.hashCode();
        PendingIntent pendingIntent = PendingIntent.getForegroundService(
                mContext, requestCode, intent,
                PendingIntent.FLAG_ONE_SHOT | PendingIntent.FLAG_IMMUTABLE);

        bundle.putParcelable(KEY_SEND_PENDING_INTENT, pendingIntent);
        return bundle;
    }

Améliorations apportées au TTR et à la réponse directe

L'API mise à jour utilise désormais une classe Conversation polyvalente, qui permet des opérations au-delà du domaine des notifications et étend les fonctionnalités dans le contexte de l'application. Cette action remplace l'exigence précédente d'utiliser la classe StatusBarNotification.

Déboguer Car Messenger

Consultez les sections suivantes pour en savoir plus sur le débogage de Car Messenger.

Déboguer les connexions Bluetooth

1. Exécutez la commande dumpsys :

   adb shell dumpsys bluetooth_manager

   • Recherchez MapClientService dans le résultat de la commande dumpsys.

    Profile: MapClientService
         mCurrentDevice: 99:99 (Pixel XL) name=Mce state=Connected
   

2. Vérifiez que l'appareil indiqué est le bon. Exemple :

   Figure 5. Liste des appareils.

3. Si aucun appareil n'est détecté, effectuez l'une des actions suivantes:

   • Reconnectez-vous au Bluetooth.

   OR

   • Dans Paramètres Bluetooth,vérifiez que Message texte est activé.

   OR

   • Sur le téléphone, vérifiez que l'accès aux messages est accordé.

Déboguer les bases de données Bluetooth

Car Messenger est basé sur la base de données de téléphonie. Pour déterminer si le Bluetooth remplit cette base de données, vous pouvez utiliser les commandes du tableau.

Déboguer les requêtes de Car Messenger et de l'assistant vocal

Les journaux sont imprimés par défaut si l'image de build est eng ou userdebug. Sinon, pour activer la journalisation pour Car Messenger:

1. Exécutez la commande pour les balises appropriées adb shell setprop log.tag.<TAG> DEBUG.

2. Activez la journalisation pour l'Assistant préchargé.

3. Pour les bugs très reproductibles, envisagez d'utiliser des points d'arrêt avec Android Studio.