Car Messenger menawarkan fitur pesan yang didesain untuk perangkat otomotif. Seperti aplikasi mobil lainnya, pengguna memulai Car Messenger dari peluncur.
Apa yang baru di Car Messenger?
Dengan aplikasi Car Messenger yang baru, pengemudi dapat:
- Dapatkan fitur pesan khusus.
- Luncurkan Car Messenger dari peluncur.
- Jelajahi pesan yang diterima sebelum dan selama perjalanan.
- Mendengarkan dan membalas pesan.
- Menonaktifkan notifikasi pesan.
- Memulai percakapan baru.
Terminologi
Istilah tersebut digunakan di halaman ini:
Manfaat aplikasi yang tidak dipaketkan
Aplikasi yang tidak dipaketkan, seperti Car Messenger, memberikan keuntungan berikut:
- Hanya menggunakan metode publik (tidak ada dependensi platform pada API tersembunyi)
- Mengembangkan aplikasi di luar platform Android
- Mengaktifkan rilis yang lebih sering (untuk fitur baru dan masalah yang telah diperbaiki)
- Mengupdate aplikasi melalui Google Play
Pelajari lebih lanjut aplikasi yang tidak dipaketkan.
Detail teknis
Bagian ini menjelaskan arsitektur Car Messenger. Untuk mempelajari lebih lanjut, lihat Mengintegrasikan dengan CarVoiceInteractionSession.
Arsitektur berbasis telepon
Saat dipasangkan melalui Bluetooth, data disinkronkan dari telepon ponsel ke database telepon mobil. Setelah Bluetooth terputus, data yang disinkronkan akan dihapus dari database telepon.
Kemampuan ini diperkenalkan di Android 12. Tujuan manfaat utamanya meliputi:
- Pesan pengguna massal dapat diambil dari database.
- Pesan dari perjalanan sebelumnya didukung.
- Menggunakan arsitektur dan API serupa untuk penyimpanan dan pengambilan SMS di Android ponsel.
- Tidak akan lagi dipaketkan sepenuhnya dari platform Android.
Berikut ini 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 kita lakukan dengan data:
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.
- Setelah terhubung, data akan ditransfer dari ponsel ke mobil menggunakan Bluetooth MAP.
- Saat memutuskan koneksi, data untuk ponsel tersebut akan dihapus dari database mobil.
Dapatkan Car Messenger
Dapatkan commit Car Messenger terbaru dari Google Git.
API interaksi suara
Car Messenger menggunakan API CarVoiceInteractionSession untuk berintegrasi dengan asisten. Elemen-elemen ini dijelaskan di bagian-bagian selanjutnya.
Model PendingIntent
API ini menggunakan PendingIntent
untuk meneruskan kembali kueri asisten yang telah di-resolve
Messenger Mobil.
Berikut ini adalah urutan kejadiannya:
Car Messenger meluncurkan asisten dengan memanggil
activity.showAssist(Bundle args)
. Argumen berisi tindakan API dan parameter yang diperlukan, yang berisi intent yang tertunda jika diperlukan.Asisten mengambil input pengguna jika perlu, dan memaketkannya dengan intent yang tertunda.
Asisten akan mengirimkan intent kembali ke Car Messenger.
Car Messenger menyelesaikan tindakan API.
Tindakan menandai sebagai API baca
Saat asisten membacakan pesan, PendingIntent
akan dikirim ke Mobil
Messenger dengan tindakan VOICE_ACTION_READ_NOTIFICATION
atau
VOICE_ACTION_READ_CONVERSATION
untuk menandai pesan sebagai telah dibaca.
Tindakan Direct Reply API
Saat asisten membalas pesan, PendingIntent
akan dikirim ke Mobil
Messenger dengan tindakan VOICE_ACTION_REPLY_NOTIFICATION
dan
VOICE_ACTION_REPLY_CONVERSATION
untuk membalas percakapan.
Tindakan Direct Send SMS API
Paket dengan tindakan VOICE_ACTION_SEND_SMS
dikirim dari Car Messenger ke
asisten.
Kode contoh:
/**
* 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 cara menulis pesan saat penerima dipilih:
Gambar 3. Halaman Kontak di aplikasi Telepon.
Gambar ini menunjukkan cara menulis pesan saat tidak ada penerima yang dipilih menggunakan Pesan Baru:
Gambar 4. Tombol Pesan baru di aplikasi Messenger.
Mengintegrasikan tindakan SMS Direct Send
Berikut adalah contoh Telepon yang mengintegrasikan VOICE_ACTION_SEND_SMS
, yang memberikan
parameter:
/**
* 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 diupdate sekarang menggunakan class Conversation
yang serbaguna,
memungkinkan operasi di luar ranah notifikasi dan memperluas kemampuan
dalam konteks aplikasi. Hal ini menggantikan persyaratan sebelumnya, yaitu penggunaan
Class StatusBarNotification
.
Debug Car Messenger
Lihat bagian berikut untuk mempelajari lebih lanjut proses debug Car Messenger.
Men-debug koneksi Bluetooth
Jalankan perintah
dumpsys
:adb shell dumpsys bluetooth_manager
- Telusuri
MapClientService
di output perintah dumpsys.
Profile: MapClientService mCurrentDevice: 99:99 (Pixel XL) name=Mce state=Connected
- Telusuri
Pastikan perangkat yang benar telah tercantum. Contoh:
Gambar 5. Daftar perangkat.
Jika perangkat tidak ditemukan, lakukan salah satu tindakan berikut:
- Hubungkan kembali ke Bluetooth.
ATAU
- Di Setelan Bluetooth, konfirmasi bahwa Pesan Teks aktif.
ATAU
- Di ponsel, pastikan Akses Pesan telah diberikan.
Men-debug database Bluetooth
Car Messenger dibuat berdasarkan database telepon. Untuk menentukan apakah Bluetooth mengisi {i>database<i} itu, Anda dapat menggunakan perintah dalam tabel.
Tugas | Perintah |
---|---|
Percakapan | adb shell content query--uri content://mms-sms/conversations?simple=true |
Hanya pesan SMS | 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 |
Hanya pesan SMS terkirim | 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 |
Men-debug Car Messenger dan kueri asisten suara
Pencetakan log secara default jika gambar build adalah eng
atau userdebug
.
Jika tidak, untuk mengaktifkan logging untuk Car Messenger:
Jalankan untuk tag yang relevan (
adb shell setprop log.tag.<TAG> DEBUG
).Aktifkan logging untuk Asisten Pramuat.
Untuk bug yang sangat mudah direproduksi, pertimbangkan untuk menggunakan titik henti sementara dengan Android Studio.