Utusan Mobil

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:

Ketuk untuk Membaca (TTR)
Tap-to-Read memungkinkan asisten suara membaca dan membalas pesan teks atas nama pengguna tersebut, saat pengguna berinteraksi dengan notifikasi pesan.

Balasan Langsung
Mirip dengan Tap-to-Read, hanya saja asisten suara tidak membacakan pesan dan langsung mengeluarkan permintaan balasan.

Kirim Langsung
Terintegrasi dengan asisten suara untuk membuat alur pesan baru dengan atau tanpa kontak tertentu.

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:

Aliran data berbasis telepon 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:

Penggunaan data Messenger Mobil 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:

  1. Car Messenger meluncurkan asisten dengan memanggil activity.showAssist(Bundle args) . Argumen berisi tindakan API dan parameter yang diperlukan, berisi maksud yang tertunda jika diperlukan.

  2. Asisten mengambil input pengguna jika diperlukan, dan mengemasnya dengan maksud yang tertunda.

  3. Asisten mengirimkan maksudnya kembali ke Car Messenger.

  4. 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:

Halaman kontak aplikasi DialerGambar 3. Halaman kontak di aplikasi Dialer.

Gambar ini menunjukkan pembuatan pesan ketika tidak ada penerima yang dipilih menggunakan Pesan Baru :

Tidak ada penerima yang dipilih 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

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

  2. Konfirmasikan bahwa perangkat yang benar telah terdaftar. Misalnya:

    Daftar perangkat Gambar 5. Daftar perangkat.

  3. 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:

  1. Jalankan untuk tag yang relevan adb shell setprop log.tag.<TAG> DEBUG .

  2. Aktifkan logging untuk Asisten yang Dimuat Sebelumnya .

  3. Untuk bug yang sangat mudah direproduksi, pertimbangkan untuk menggunakan breakpoint dengan Android Studio .