Car Messenger

Car Messenger offre des fonctionnalités de messagerie conçues pour les appareils automobiles. Comme pour les autres applications automobiles, les utilisateurs démarrent Car Messenger depuis le lanceur.

Nouveautés de Car Messenger

Avec la nouvelle application Car Messenger, les conducteurs peuvent :

• Profitez d'une expérience de messagerie dédiée.
• Lancez Car Messenger depuis le lanceur d'applications.
• Parcourez les messages reçus avant et pendant un trajet.
• Écoutez les messages et répondez-y.
• Désactiver les notifications de messages
• démarrer de nouvelles conversations ;

Terminologie

Voici les termes utilisés sur cette page :

Avantages des applications dissociées

Les applications dissociées, comme Car Messenger, offrent 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 des 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 dissociées

Détails techniques

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

Architecture basée sur la téléphonie

Lorsqu'un téléphone est associé à la voiture via Bluetooth, les données sont synchronisées entre la base de données de téléphonie du téléphone et celle de la voiture. Lorsque la connexion Bluetooth est interrompue, les données synchronisées sont supprimées de la base de données de téléphonie de la voiture.

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

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

Voici le flux :

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 les 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.

• Une fois la connexion établie, 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 déconnectez un téléphone, les données associées sont supprimées de la base de données de la voiture.

Obtenir Car Messenger

Obtenez le dernier commit Car Messenger depuis 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 renvoyer les requêtes de l'assistant résolues à 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 d'API et ses paramètres requis, ainsi qu'une intention en attente si nécessaire.

2. Si nécessaire, l'Assistant récupère la saisie de l'utilisateur et l'associe à 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 d'API "Envoyer un SMS directement"

Un bundle 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 comment rédiger un message lorsqu'un destinataire est sélectionné :

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

Cette image montre comment rédiger un message lorsqu'aucun destinataire n'est sélectionné à 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 de l'intégration de VOICE_ACTION_SEND_SMS par le clavier téléphonique, avec des 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 temps de réponse et à la réponse directe

L'API mise à jour utilise désormais une classe Conversation polyvalente, ce qui permet d'effectuer des opérations au-delà du domaine des notifications et d'étendre les capacités dans le contexte de l'application. Cela 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 le bon appareil est listé. Exemple :

   Figure 5. Liste des appareils.

3. Si aucun appareil n'est détecté, procédez de l'une des manières suivantes :

   • Rétablissez la connexion Bluetooth.

   OR

   • Dans les paramètres Bluetooth,vérifiez que l'option Message texte est activée.

   OR

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

Déboguer les bases de données Bluetooth

Car Messenger repose 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 Car Messenger et de l'assistant vocal

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

1. Exécutez les tags concernés adb shell setprop log.tag.<TAG> DEBUG.

2. Activez la journalisation pour Preloaded Assistant.

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