Car Messenger umożliwia wysyłanie wiadomości na urządzeniach samochodowych. Podobnie jak w przypadku innych aplikacji samochodowych użytkownicy uruchamiają komunikator samochodowy z programu uruchamiającego.
Co nowego w Car Messenger?
Dzięki nowej aplikacji Car Messenger kierowcy mogą:
- Korzystaj ze specjalnych funkcji przesyłania wiadomości.
- Uruchom Car Messenger z menu.
- Przejrzyj wiadomości odebrane przed przejazdem i w jego trakcie.
- Odsłuchiwanie wiadomości i odpowiadanie na nie.
- wyciszyć powiadomienia o wiadomościach,
- rozpoczynać nowe rozmowy;
Terminologia
Na tej stronie używane są następujące terminy:
Zalety odseparowania aplikacji
Aplikacje niespakowane, takie jak Car Messenger, dają te korzyści:
- Korzystanie tylko z publicznych metod (brak zależności od platformy w przypadku ukrytych interfejsów API)
- Tworzenie aplikacji poza platformą Androida
- umożliwiać częstsze wdrażanie wersji (w przypadku nowych funkcji i rozwiązanych problemów);
- Aktualizowanie aplikacji przez Google Play
Dowiedz się więcej o nieobsługiwanych aplikacjach.
Szczegóły techniczne
W tej sekcji opisano architekturę aplikacji samochodowej. Więcej informacji znajdziesz w artykule Integracja z CarVoiceInteractionSession.
Architektura oparta na telefonii
Po sparowaniu przez Bluetooth dane z bazy danych telefonii są synchronizowane z bazą danych telefonów w samochodzie. Po rozłączeniu Bluetootha zsynchronizowane dane są usuwane z bazy danych telefonii samochodu.
Ta funkcja została wprowadzona w Androidzie 12. Oto główne korzyści:
- Wiadomości zbiorcze użytkowników można pobrać z bazy danych.
- Obsługiwane są wiadomości z poprzednich jazd.
- Używa podobnej architektury i interfejsu API do przechowywania i pobierania SMS-ów na telefonach z Androidem.
- zostanie w pełni odłączona od platformy Androida.
Proces ten wygląda tak:
Rysunek 1. Przepływ danych oparty na telefonii.
Schemat w formacie tekstowym:
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.
Co robimy z tymi danymi:
Rysunek 2. Zarządzanie danymi w Messengerze w samochodzie.
Schemat ilustrowany w formacie tekstowym:
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.
- Po połączeniu dane są przesyłane z telefonu do samochodu przez Bluetooth MAP.
- Po rozłączeniu dane tego telefonu są usuwane z bazy danych samochodu.
Get Car Messenger
Pobierz najnowsze zatwierdzenie aplikacji Car Messenger z Google Git.
Interfejsy API interakcji głosowych
Car Messenger używa interfejsów API CarVoiceInteractionSession do integracji z asystentem. Te elementy są opisane w następnych sekcjach.
Model PendingIntent
Te interfejsy API używają PendingIntent do przekazywania rozwiązanych zapytań do Car Messengera.
Oto kolejność zdarzeń:
Car Messenger uruchamia Asystenta, gdy wywołasz
activity.showAssist(Bundle args). Parametry zawierają działanie interfejsu API i jego wymagane parametry, w tym, w razie potrzeby, oczekującą intencję.W razie potrzeby Asystent pobiera dane wejściowe użytkownika i pakuje je z oczekującą intencją.
Asystent wysyła intencję z powrotem do aplikacji Car Messenger.
Car Messenger rozwiązuje działanie interfejsu API.
Działanie interfejsu API „Oznacz jako przeczytane”
Gdy asystent odczytuje wiadomość, PendingIntent zostaje wysłany do czatu samochodowego z działaniem VOICE_ACTION_READ_NOTIFICATION lub VOICE_ACTION_READ_CONVERSATION, aby oznaczyć wiadomość jako przeczytaną.
Akcja interfejsu API Direct Reply
Gdy Asystent odpowiada na wiadomość, PendingIntent jest wysyłany do Car
Messenger z działaniem VOICE_ACTION_REPLY_NOTIFICATION i VOICE_ACTION_REPLY_CONVERSATION, aby odpowiedzieć na rozmowę.
Działanie interfejsu Direct Send SMS API
Z Car Messenger do Asystenta wysyłany jest pakiet z działaniem VOICE_ACTION_SEND_SMS.
Przykładowy kod:
/**
* 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”;
Ten obraz pokazuje tworzenie wiadomości po wybraniu odbiorcy:
Rysunek 3. stronie Kontakty w aplikacji Telefon.
Ten obraz pokazuje tworzenie wiadomości, gdy nie wybrano żadnego odbiorcy za pomocą opcji Nowa wiadomość:
Rysunek 4. Przycisk Nowa wiadomość w aplikacji Messenger
Integracja działania bezpośredniego wysyłania SMS-a
Oto przykład Dialera z integracją VOICE_ACTION_SEND_SMS, który zawiera opcjonalne parametry:
/**
* 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;
}
Ulepszenia TTR i bezpośrednich odpowiedzi
Zaktualizowany interfejs API korzysta teraz z uniwersalnej klasy Conversation, która umożliwia wykonywanie operacji wykraczających poza zakres powiadomień i rozszerza możliwości w kontekście aplikacji. Zastępuje to poprzedni wymóg używania klasy StatusBarNotification.
Debugowanie Car Messenger
Więcej informacji o debugowaniu Car Messenger znajdziesz w sekcjach poniżej.
Debugowanie połączeń Bluetooth
Uruchom polecenie
dumpsys:adb shell dumpsys bluetooth_manager- W wyniku polecenia dumpsys wyszukaj
MapClientService.
Profile: MapClientService mCurrentDevice: 99:99 (Pixel XL) name=Mce state=Connected- W wyniku polecenia dumpsys wyszukaj
Sprawdź, czy na liście jest właściwe urządzenie. Na przykład:
Rysunek 5. Lista urządzeń.Jeśli urządzenie nie zostanie znalezione, wykonaj jedną z tych czynności:
- Połącz ponownie z Bluetooth.
LUB
- W Ustawieniach Bluetooth sprawdź,czy opcja Wiadomość tekstowa jest włączona.
LUB
- Na telefonie sprawdź, czy przyznano dostęp do wiadomości.
Debugowanie baz danych Bluetooth
Aplikacja Car Messenger korzysta z bazy danych telefonii. Aby sprawdzić, czy Bluetooth zapełnia tę bazę danych, możesz użyć poleceń w tabeli.
| Zadanie | Polecenie |
|---|---|
| Rozmowa | adb shell content query--uri content://mms-sms/conversations?simple=true |
| Tylko SMS-y | adb shell content query--uri content://sms |
| MMS-y/SMS-y | adb shell content query--uri content://mms-sms/conversations |
| tylko MMS-y, | adb shell content query--uri content://mms |
| Tylko skrzynka odbiorcza MMS-ów | adb shell content query--uri content://mms/conversations/inbox |
| tylko wysłane SMS-y; | adb shell content query--uri content://sms/sent |
| Tylko odebrane SMS-y | adb shell content query--uri content://sms/conversations/inbox |
| Część 1 wiadomości MMS (zastąp 1 identyfikatorem MMS-a) |
adb shell content query--uri content://mms/part/1 |
Debugowanie zapytań do Car Messengera i Asystenta głosowego
Logi są domyślnie drukowane, jeśli obraz kompilacji ma wartość eng lub userdebug.
Aby włączyć logowanie w przypadku Car Messenger:
Uruchom dla odpowiednich tagów
adb shell setprop log.tag.<TAG> DEBUG.Włącz logowanie wstępnie wczytanego Asystenta.
W przypadku błędów, które można odtworzyć, rozważ użycie punktów przerwania w Android Studio.