Xe đưa tin

Car Messenger cung cấp khả năng nhắn tin được thiết kế cho các thiết bị ô tô. Giống như các ứng dụng ô tô khác, người dùng khởi động Car Messenger từ trình khởi chạy.

Có gì mới trong Car Messenger?

Với ứng dụng Car Messenger mới, người lái xe:

• Có được trải nghiệm nhắn tin chuyên dụng.
• Khởi chạy Car Messenger từ trình khởi chạy.
• Duyệt tin nhắn nhận được trước và trong khi lái xe.
• Nghe và trả lời tin nhắn.
• Tắt tiếng thông báo tin nhắn.
• Bắt đầu cuộc trò chuyện mới.

Thuật ngữ

Những thuật ngữ này được sử dụng trên trang này:

Lợi ích của ứng dụng chưa được nhóm

Các ứng dụng không được nhóm, chẳng hạn như Car Messenger, mang lại những lợi ích sau:

• Chỉ sử dụng các phương thức công khai (không phụ thuộc nền tảng vào các API ẩn)
• Phát triển ứng dụng bên ngoài nền tảng Android
• Cho phép phát hành thường xuyên hơn (đối với các tính năng mới và các sự cố đã được khắc phục)
• Cập nhật ứng dụng thông qua Google Play

Tìm hiểu thêm về các ứng dụng chưa được nhóm .

Chi tiết kỹ thuật

Phần này mô tả kiến ​​trúc Car Messenger. Để tìm hiểu thêm, hãy xem Tích hợp với CarVoiceInteractionSession .

Kiến trúc dựa trên điện thoại

Khi ghép nối qua Bluetooth, dữ liệu sẽ được đồng bộ hóa từ cơ sở dữ liệu điện thoại của điện thoại với cơ sở dữ liệu điện thoại của ô tô. Khi ngắt kết nối Bluetooth, dữ liệu đã đồng bộ hóa sẽ bị xóa khỏi cơ sở dữ liệu điện thoại của ô tô.

Khả năng này đã được giới thiệu trong Android 12. Những lợi ích chính bao gồm:

• Tin nhắn hàng loạt của người dùng có thể được lấy từ cơ sở dữ liệu.
• Tin nhắn từ các ổ đĩa trước được hỗ trợ.
• Sử dụng kiến ​​trúc và API tương tự để lưu trữ và truy xuất SMS trên điện thoại Android.
• Trở nên tách biệt hoàn toàn khỏi nền tảng Android.

Đây là dòng chảy:

Hình 1. Luồng dữ liệu dựa trên điện thoại.

Luồng minh họa ở định dạng văn bản:

 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.

Đây là những gì chúng tôi làm với dữ liệu:

Hình 2. Xử lý dữ liệu Car Messenger.

Luồng minh họa ở định dạng văn bản:

 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.

• Khi kết nối, dữ liệu sẽ được truyền từ điện thoại sang ô tô bằng Bluetooth MAP.
• Khi ngắt kết nối, dữ liệu của điện thoại đó sẽ bị xóa khỏi cơ sở dữ liệu của ô tô.

Nhận tin nhắn xe hơi

Nhận cam kết Car Messenger mới nhất từ ​​Google Git.

API tương tác bằng giọng nói

Car Messenger sử dụng API CarVoiceInteractionSession để tích hợp với trợ lý. Những yếu tố này được mô tả trong các phần sau.

Mô hình ý định đang chờ xử lý

Các API này sử dụng PendingIntent để chuyển các truy vấn trợ lý đã giải quyết trở lại Car Messenger.

Đây là chuỗi sự kiện:

1. Car Messenger khởi chạy trợ lý bằng cách gọi activity.showAssist(Bundle args) . Các đối số chứa hành động API và các tham số bắt buộc của nó, chứa mục đích đang chờ xử lý nếu cần.

2. Trợ lý truy xuất dữ liệu đầu vào của người dùng nếu cần thiết và đóng gói dữ liệu đó với mục đích đang chờ xử lý.

3. Trợ lý gửi ý định trở lại Car Messenger.

4. Car Messenger giải quyết hành động API.

Đánh dấu là đã đọc hành động API

Khi trợ lý đang đọc tin nhắn, PendingIntent sẽ được gửi tới Car Messenger bằng hành động VOICE_ACTION_READ_NOTIFICATION hoặc VOICE_ACTION_READ_CONVERSATION để đánh dấu tin nhắn là đã đọc.

Hành động API trả lời trực tiếp

Khi trợ lý trả lời tin nhắn, PendingIntent sẽ được gửi tới Car Messenger với hành động VOICE_ACTION_REPLY_NOTIFICATION và VOICE_ACTION_REPLY_CONVERSATION để trả lời cuộc trò chuyện.

Hành động API gửi SMS trực tiếp

Một gói có hành động VOICE_ACTION_SEND_SMS được gửi từ Car Messenger tới trợ lý.

Mã mẫu:

/**
 *   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”;

Hình ảnh này hiển thị việc soạn thư khi người nhận được chọn:

Hình 3. Trang Danh bạ trong ứng dụng Trình quay số.

Hình ảnh này hiển thị việc soạn tin nhắn khi không có người nhận nào được chọn bằng Tin nhắn mới :

Hình 4. Nút Tin nhắn mới trong ứng dụng Messenger.

Tích hợp hành động Gửi SMS trực tiếp

Dưới đây là ví dụ về Trình quay số tích hợp VOICE_ACTION_SEND_SMS , cung cấp các tham số tùy chọn:

    /**
     * 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;
    }

Những cải tiến đối với TTR và Trả lời trực tiếp

API cập nhật hiện sử dụng lớp Conversation linh hoạt, cho phép thực hiện các hoạt động ngoài phạm vi thông báo và mở rộng khả năng trong ngữ cảnh của ứng dụng. Điều này thay thế yêu cầu trước đó về việc sử dụng lớp StatusBarNotification .

Gỡ lỗi xe Messenger

Xem các phần sau để tìm hiểu thêm về cách gỡ lỗi Car Messenger.

Gỡ lỗi kết nối Bluetooth

1. Chạy lệnh dumpsys :

   adb shell dumpsys bluetooth_manager
   

   • Tìm kiếm MapClientService trong đầu ra lệnh dumpsys.

    Profile: MapClientService
         mCurrentDevice: 99:99 (Pixel XL) name=Mce state=Connected
   

2. Xác nhận rằng thiết bị chính xác được liệt kê. Ví dụ:

   Hình 5. Danh sách thiết bị.

3. Nếu không tìm thấy thiết bị nào, hãy thực hiện một trong các thao tác sau:

   • Kết nối lại với Bluetooth.

   HOẶC

   • Trong Cài đặt Bluetooth, hãy xác nhận rằng Tin nhắn văn bản đang bật.

   HOẶC

   • Trên điện thoại, xác nhận rằng Quyền truy cập tin nhắn đã được cấp.

Gỡ lỗi cơ sở dữ liệu Bluetooth

Car Messenger được xây dựng trên cơ sở dữ liệu điện thoại. Để xác định xem Bluetooth có được đưa vào cơ sở dữ liệu đó hay không, bạn có thể sử dụng các lệnh trong bảng.

Gỡ lỗi các truy vấn trên Car Messenger và trợ lý giọng nói

Nhật ký được in theo mặc định nếu hình ảnh bản dựng là eng hoặc userdebug . Mặt khác, để bật tính năng ghi nhật ký cho Car Messenger:

1. Chạy các thẻ có liên quan adb shell setprop log.tag.<TAG> DEBUG .

2. Bật tính năng ghi nhật ký cho Trợ lý tải trước .

3. Đối với các lỗi có khả năng tái diễn cao, hãy cân nhắc sử dụng điểm ngắt với Android Studio .