Car Messenger offre des fonctionnalités de messagerie conçues pour les appareils automobiles. Comme les autres applications automobiles, les utilisateurs démarrent Car Messenger à partir du lanceur.
Quoi de neuf dans Car Messenger ?
Avec la nouvelle application Car Messenger, les conducteurs :
- Bénéficiez d'une expérience de messagerie dédiée.
- Lancez Car Messenger depuis le lanceur.
- Parcourez les messages reçus avant et pendant un trajet.
- Écoutez et répondez aux messages.
- Désactiver les notifications de messages.
- Démarrez de nouvelles conversations.
Terminologie
Ces termes sont utilisés sur cette page :
Avantages des applications dégroupées
Les applications dégroupées, telles que Car Messenger, offrent les avantages suivants :
- Utilise uniquement des méthodes publiques (aucune dépendance de plate-forme sur les API cachées)
- Développer des applications en dehors de la plateforme Android
- Activer des versions plus fréquentes (pour les nouvelles fonctionnalités et les problèmes résolus)
- Mettre à jour les applications via Google Play
En savoir plus sur les applications dégroupé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'elles sont couplées via Bluetooth, les données sont synchronisées de la base de données téléphonique du téléphone avec la base de données téléphonique de la voiture. Lors de la déconnexion 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. Les principaux avantages sont les suivants :
- Les messages utilisateur en masse peuvent être récupérés à partir d’une base de données.
- Les messages des lecteurs précédents sont pris en charge.
- Utilise une architecture et une API similaires pour le stockage et la récupération de SMS sur les téléphones Android.
- Devient entièrement dégroupé de la plateforme 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 de 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 à la voiture via Bluetooth MAP.
- Lors de la déconnexion, les données de ce téléphone sont supprimées de la base de données de la voiture.
Obtenez 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 d'intention en attente
Ces API utilisent PendingIntent
pour renvoyer les requêtes d'assistant résolues à Car Messenger.
Voici la séquence des événements :
Car Messenger lance l'assistant en appelant
activity.showAssist(Bundle args)
. Les arguments contiennent l'action API et ses paramètres requis, contenant une intention en attente si nécessaire.L'Assistant récupère les entrées de l'utilisateur si nécessaire et les regroupe avec l'intention en attente.
L'Assistant renvoie l'intention à Car Messenger.
Car Messenger résout l'action de l'API.
Action 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 API de réponse directe
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 d'envoi direct de SMS
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 la rédaction d'un message lorsqu'un destinataire est sélectionné :
Figure 3. Page Contacts dans l'application Dialer.
Cette image montre la composition d'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 Dialer intégrant VOICE_ACTION_SEND_SMS
, fournissant 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 du TTR et de la réponse directe
L'API mise à jour utilise désormais une classe Conversation
polyvalente, permettant des opérations au-delà du domaine de notification et étendant les capacités dans le contexte de l'application. Cela remplace l’exigence préalable d’utiliser la classe StatusBarNotification
.
Déboguer le messager de voiture
Consultez les sections suivantes pour en savoir plus sur le débogage de Car Messenger.
Déboguer les connexions Bluetooth
Exécutez la commande
dumpsys
:adb shell dumpsys bluetooth_manager
- Recherchez
MapClientService
dans la sortie de la commande dumpsys.
Profile: MapClientService mCurrentDevice: 99:99 (Pixel XL) name=Mce state=Connected
- Recherchez
Confirmez que le bon périphérique est répertorié. Par exemple:
Figure 5. Liste des appareils.
Si aucun périphérique n'est trouvé, effectuez l'une des opérations suivantes :
- Reconnectez-vous à Bluetooth.
OU
- Dans Paramètres Bluetooth, confirmez que la messagerie texte est activée.
OU
- Au téléphone, confirmez que l'accès aux messages est accordé.
Déboguer les bases de données Bluetooth
Car Messenger est construit sur la base de données de téléphonie. Pour déterminer si Bluetooth remplit cette base de données, vous pouvez utiliser les commandes du tableau.
Tâche | Commande |
---|---|
Conversation | adb shell content query--uri content://mms-sms/conversations?simple=true |
SMS uniquement | adb shell content query--uri content://sms |
Messages MMS/SMS | adb shell content query--uri content://mms-sms/conversations |
Messages MMS uniquement | adb shell content query--uri content://mms |
Boîte de réception MMS uniquement | adb shell content query--uri content://mms/conversations/inbox |
SMS envoyés uniquement | adb shell content query--uri content://sms/sent |
Boîte de réception SMS uniquement | adb shell content query--uri content://sms/conversations/inbox |
Message MMS, partie 1 (remplacez 1 par l'identifiant du MMS) | adb shell content query--uri content://mms/part/1 |
Déboguer les requêtes de Car Messenger et de l'assistant vocal
Les journaux s'impriment par défaut si l'image de build est eng
ou userdebug
. Sinon, pour activer la journalisation pour Car Messenger :
Exécutez pour les balises pertinentes
adb shell setprop log.tag.<TAG> DEBUG
.Activez la journalisation pour l'Assistant préchargé .
Pour les bogues hautement reproductibles, pensez à utiliser des points d'arrêt avec Android Studio .