Car Messenger menawarkan kemampuan perpesanan yang dirancang untuk perangkat otomotif. Seperti aplikasi mobil lainnya, pengguna memulai Car Messenger dari peluncur.
Apa yang baru di Messenger Mobil?
Dengan aplikasi Car Messenger baru, pengemudi:
- Dapatkan pengalaman perpesanan khusus.
- Luncurkan Car Messenger dari peluncur.
- Telusuri pesan yang diterima sebelum dan selama berkendara.
- Dengarkan dan balas pesan.
- Bisukan notifikasi pesan.
- Mulailah percakapan baru.
Terminologi
Istilah-istilah ini digunakan di halaman ini:
Manfaat aplikasi yang tidak dibundel
Aplikasi yang tidak dibundel, seperti Car Messenger, memberikan keuntungan berikut:
- Hanya menggunakan metode publik (tidak ada ketergantungan platform pada API tersembunyi)
- Mengembangkan aplikasi di luar platform Android
- Aktifkan rilis yang lebih sering (untuk fitur baru dan masalah yang diperbaiki)
- Perbarui aplikasi melalui Google Play
Pelajari lebih lanjut tentang aplikasi yang tidak dipaketkan .
Detail teknis
Bagian ini menjelaskan arsitektur Car Messenger. Untuk mempelajari lebih lanjut, lihat Mengintegrasikan dengan CarVoiceInteractionSession .
Arsitektur berbasis telepon
Ketika dipasangkan melalui Bluetooth, data disinkronkan dari database telepon telepon ke database telepon mobil. Setelah pemutusan Bluetooth, data yang disinkronkan akan dihapus dari database telepon mobil.
Kemampuan ini diperkenalkan di Android 12. Manfaat utamanya meliputi:
- Pesan pengguna massal dapat diambil dari database.
- Pesan dari drive sebelumnya didukung.
- Menggunakan arsitektur dan API serupa untuk penyimpanan dan pengambilan SMS di ponsel Android.
- Menjadi sepenuhnya tidak terikat dari platform Android.
Berikut alurnya:
Gambar 1. Aliran data berbasis telepon.
Alur diilustrasikan dalam format teks:
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.
Inilah yang kami lakukan dengan datanya:
Gambar 2. Penanganan data Car Messenger.
Alur diilustrasikan dalam format teks:
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.
- Saat terhubung, data ditransfer dari ponsel ke mobil menggunakan Bluetooth MAP.
- Saat sambungan terputus, data untuk ponsel tersebut akan dihapus dari database mobil.
Dapatkan Messenger Mobil
Dapatkan komitmen Car Messenger terbaru dari Google Git.
API interaksi suara
Car Messenger menggunakan API CarVoiceInteractionSession untuk berintegrasi dengan asisten. Elemen-elemen ini dijelaskan pada bagian berikut.
Model PendingIntent
API ini menggunakan PendingIntent
untuk meneruskan kueri asisten yang telah diselesaikan kembali ke Car Messenger.
Berikut rangkaian kejadiannya:
Car Messenger meluncurkan asisten dengan memanggil
activity.showAssist(Bundle args)
. Argumen berisi tindakan API dan parameter yang diperlukan, berisi maksud yang tertunda jika diperlukan.Asisten mengambil input pengguna jika diperlukan, dan mengemasnya dengan maksud yang tertunda.
Asisten mengirimkan maksudnya kembali ke Car Messenger.
Car Messenger menyelesaikan tindakan API.
Tandai sebagai tindakan API telah dibaca
Saat asisten membaca pesan, PendingIntent
dikirim ke Car Messenger dengan tindakan VOICE_ACTION_READ_NOTIFICATION
atau VOICE_ACTION_READ_CONVERSATION
untuk menandai pesan sebagai telah dibaca.
Tindakan API Balasan Langsung
Saat asisten membalas pesan, PendingIntent
dikirim ke Car Messenger dengan tindakan VOICE_ACTION_REPLY_NOTIFICATION
dan VOICE_ACTION_REPLY_CONVERSATION
untuk membalas percakapan.
Tindakan API Kirim SMS Langsung
Paket berisi tindakan VOICE_ACTION_SEND_SMS
dikirim dari Car Messenger ke asisten.
Kode sampel:
/**
* 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”;
Gambar ini menunjukkan pembuatan pesan ketika penerima dipilih:
Gambar 3. Halaman kontak di aplikasi Dialer.
Gambar ini menunjukkan pembuatan pesan ketika tidak ada penerima yang dipilih menggunakan Pesan Baru :
Gambar 4. Tombol Pesan Baru di aplikasi Messenger.
Integrasikan tindakan Kirim SMS Langsung
Berikut ini contoh Dialer yang mengintegrasikan VOICE_ACTION_SEND_SMS
, memberikan parameter opsional:
/**
* 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;
}
Peningkatan pada TTR dan Balasan Langsung
API yang diperbarui sekarang menggunakan kelas Conversation
serbaguna, memungkinkan operasi di luar bidang notifikasi dan memperluas kemampuan dalam konteks aplikasi. Ini menggantikan persyaratan sebelumnya dalam menggunakan kelas StatusBarNotification
.
Debug Messenger Mobil
Lihat bagian berikut untuk mempelajari lebih lanjut tentang debugging Car Messenger.
Men-debug koneksi Bluetooth
Jalankan perintah
dumpsys
:adb shell dumpsys bluetooth_manager
- Cari
MapClientService
di output perintah dumpsys.
Profile: MapClientService mCurrentDevice: 99:99 (Pixel XL) name=Mce state=Connected
- Cari
Konfirmasikan bahwa perangkat yang benar telah terdaftar. Misalnya:
Gambar 5. Daftar perangkat.
Jika tidak ada perangkat yang ditemukan, lakukan salah satu hal berikut:
- Sambungkan kembali ke Bluetooth.
ATAU
- Di Pengaturan Bluetooth, konfirmasikan bahwa Pesan Teks aktif.
ATAU
- Di telepon, konfirmasikan bahwa Akses Pesan diberikan.
Men-debug database Bluetooth
Car Messenger dibangun di atas basis data telepon. Untuk menentukan apakah Bluetooth mengisi database tersebut, Anda dapat menggunakan perintah dalam tabel.
Tugas | Memerintah |
---|---|
Percakapan | adb shell content query--uri content://mms-sms/conversations?simple=true |
Pesan SMS saja | adb shell content query--uri content://sms |
Pesan MMS/SMS | adb shell content query--uri content://mms-sms/conversations |
Hanya pesan MMS | adb shell content query--uri content://mms |
Hanya kotak masuk MMS | adb shell content query--uri content://mms/conversations/inbox |
SMS hanya mengirim pesan | adb shell content query--uri content://sms/sent |
Hanya kotak masuk SMS | adb shell content query--uri content://sms/conversations/inbox |
Pesan MMS bagian 1 (ganti 1 dengan ID MMS) | adb shell content query--uri content://mms/part/1 |
Debug pertanyaan Car Messenger dan asisten suara
Log dicetak secara default jika gambar build adalah eng
atau userdebug
. Jika tidak, untuk mengaktifkan logging pada Car Messenger:
Jalankan untuk tag yang relevan
adb shell setprop log.tag.<TAG> DEBUG
.Aktifkan logging untuk Asisten yang Dimuat Sebelumnya .
Untuk bug yang sangat mudah direproduksi, pertimbangkan untuk menggunakan breakpoint dengan Android Studio .