कार मैसेंजर

Car Messenger, वाहन से जुड़े डिवाइसों के लिए मैसेजिंग की सुविधाएं देता है. कार के अन्य ऐप्लिकेशन की तरह, उपयोगकर्ता लॉन्चर से Car Messenger को शुरू करते हैं.

Car Messenger में नया क्या है?

Car Messenger के नए ऐप्लिकेशन की मदद से, ड्राइवर:

  • मैसेज की सुविधा का बेहतर अनुभव पाएं.
  • लॉन्चर से कार मैसेंजर लॉन्च करें.
  • ड्राइव से पहले और उसके दौरान मिले मैसेज ब्राउज़ करना.
  • मैसेज सुनना और उनका जवाब देना.
  • मैसेज की सूचनाएं म्यूट करना.
  • नई बातचीत शुरू करें.

शब्दावली

इस पेज पर इन शब्दों का इस्तेमाल किया गया है:

टैप करके पढ़ने की सुविधा (टीटीआर)
'टैप करके सुनें' सुविधा की मदद से, वॉइस असिस्टेंट उस व्यक्ति की ओर से मैसेज पढ़ सकती हैं और उनका जवाब दे सकती हैं. ऐसा तब होता है, जब उपयोगकर्ता मैसेज की सूचनाओं के साथ इंटरैक्ट करता है.

सीधे जवाब देना
यह टैप करके पढ़ने की सुविधा जैसी ही है. हालांकि, इसमें वॉइस असिस्टेंट मैसेज को पढ़कर नहीं सुनाएगी. इसके बजाय, वह तुरंत जवाब देने के लिए प्रॉम्प्ट देगी.

डायरेक्ट भेजें
यह किसी संपर्क के साथ या उसके बिना, नया मैसेज लिखने के लिए वॉइस असिस्टेंट के साथ काम करता है.

अलग-अलग बंडल में उपलब्ध ऐप्लिकेशन के फ़ायदे

अनबंड किए गए ऐप्लिकेशन, जैसे कि Car Messenger, ये फ़ायदे देते हैं:

  • सिर्फ़ सार्वजनिक तरीकों का इस्तेमाल करता है (छिपे हुए एपीआई पर प्लैटफ़ॉर्म की कोई निर्भरता नहीं)
  • Android प्लैटफ़ॉर्म के अलावा किसी दूसरे प्लैटफ़ॉर्म के लिए ऐप्लिकेशन डेवलप करना
  • नई सुविधाओं और ठीक की गई समस्याओं के लिए, ज़्यादा बार रिलीज़ करने की सुविधा चालू करना
  • Google Play से ऐप्लिकेशन अपडेट करना

अलग-अलग बंडल में मौजूद ऐप्लिकेशन के बारे में ज़्यादा जानें.

तकनीकी जानकारी

इस सेक्शन में, Car Messenger के आर्किटेक्चर के बारे में बताया गया है. ज़्यादा जानने के लिए, CarVoiceInteractionSession के साथ इंटिग्रेट करना लेख पढ़ें.

टेलीफ़ोन पर आधारित आर्किटेक्चर

ब्लूटूथ से जोड़ने पर, फ़ोन के टेलीफ़ोनी डेटाबेस से कार के टेलीफ़ोनी डेटाबेस में डेटा सिंक हो जाता है. ब्लूटूथ के डिसकनेक्ट होने पर, कार के टेलीफ़ोनी डेटाबेस से सिंक किया गया डेटा मिटा दिया जाता है.

यह सुविधा Android 12 में लॉन्च की गई थी. मुख्य फ़ायदों में ये शामिल हैं:

  • डेटाबेस से, कई उपयोगकर्ताओं के मैसेज एक साथ वापस पाए जा सकते हैं.
  • पिछली ड्राइव के मैसेज देखे जा सकते हैं.
  • Android फ़ोन पर एसएमएस स्टोर करने और उन्हें वापस पाने के लिए, मिलते-जुलते आर्किटेक्चर और एपीआई का इस्तेमाल करता है.
  • Android प्लैटफ़ॉर्म से पूरी तरह अनबंड हो जाता है.

यहां प्रोसेस के बारे में बताया गया है:

टेलीफ़ोन पर आधारित डेटा फ़्लो पहली इमेज. टेलीफ़ोन पर आधारित डेटा फ़्लो.

टेक्स्ट फ़ॉर्मैट में दिखाया गया फ़्लो:

 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.

हम इस डेटा का इस्तेमाल इस तरह करते हैं:

कार के लिए Messenger का इस्तेमाल करने पर खर्च होने वाला डेटा दूसरी इमेज. Car Messenger का डेटा मैनेज करना.

फ़्लो को टेक्स्ट फ़ॉर्मैट में दिखाया गया है:

 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.
  • कनेक्ट करने पर, ब्लूटूथ मैप का इस्तेमाल करके डेटा को फ़ोन से कार में ट्रांसफ़र किया जाता है.
  • डिसकनेक्ट करने पर, उस फ़ोन का डेटा कार के डेटाबेस से मिटा दिया जाता है.

Car Messenger पाना

Google Git से, Car Messenger का नया कमिट पाएं.

वॉइस इंटरैक्शन एपीआई

Car Messenger, Assistant के साथ इंटिग्रेट करने के लिए, CarVoiceInteractionSession एपीआई का इस्तेमाल करता है. इन एलिमेंट के बारे में, नीचे दिए गए सेक्शन में बताया गया है.

PendingIntent मॉडल

ये एपीआई PendingIntent का इस्तेमाल करके, समाधान की गई Assistant क्वेरी को वापस कार मैसेंजर पर भेजते हैं.

इवेंट का क्रम इस तरह है:

  1. Car Messenger, activity.showAssist(Bundle args) को कॉल करके Assistant को लॉन्च करता है. args में एपीआई ऐक्शन और उसके ज़रूरी पैरामीटर होते हैं. अगर ज़रूरी हो, तो इसमें एक अधूरा इंटेंट भी शामिल होता है.

  2. ज़रूरत पड़ने पर Assistant, लोगों के इनपुट और ऐसे पैकेज को ऐक्सेस करती है जो अटके हुए मकसद के लिए बनाए जाते हैं.

  3. Assistant, इंटेंट को वापस Car Messenger पर भेजती है.

  4. Car Messenger, एपीआई की कार्रवाई का समाधान करता है.

'पढ़ा गया' के तौर पर मार्क करने की एपीआई कार्रवाई

जब Assistant कोई मैसेज पढ़ती है, तो मैसेज को पढ़ा गया के तौर पर मार्क करने के लिए, VOICE_ACTION_READ_NOTIFICATION या VOICE_ACTION_READ_CONVERSATION कार्रवाई के साथ PendingIntent को कार मैसेंजर में भेजा जाता है.

Direct Reply API की कार्रवाई

जब Assistant किसी मैसेज का जवाब दे रही होती है, तो बातचीत का जवाब देने के लिए, PendingIntent को Car Messenger पर VOICE_ACTION_REPLY_NOTIFICATION और VOICE_ACTION_REPLY_CONVERSATION कार्रवाई के साथ भेजा जाता है.

सीधे मैसेज (एसएमएस) भेजने के लिए एपीआई की कार्रवाई

VOICE_ACTION_SEND_SMS ऐक्शन वाला बंडल, Car Messenger से Assistant को भेजा जाता है.

सैंपल कोड:

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

इस इमेज में, मैसेज पाने वाले व्यक्ति को चुनने के बाद मैसेज लिखने का तरीका दिखाया गया है:

डायलर ऐप्लिकेशन का संपर्क पेज तीसरी इमेज. डायलर ऐप्लिकेशन में संपर्क पेज.

इस इमेज में, नया मैसेज का इस्तेमाल करके मैसेज लिखते समय, मैसेज पाने वाले व्यक्ति को न चुनने पर दिखने वाला मैसेज दिखाया गया है:

ईमेल पाने वाला कोई व्यक्ति नहीं चुना गया चौथी इमेज. मैसेंजर ऐप्लिकेशन में नया संदेश बटन.

सीधे एसएमएस भेजने की कार्रवाई को इंटिग्रेट करना

यहां VOICE_ACTION_SEND_SMS को इंटिग्रेट करने वाले डायलर का उदाहरण दिया गया है, जिसमें वैकल्पिक पैरामीटर दिए गए हैं:

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

टीटीआर और डायरेक्ट रिप्लाई में सुधार

अपडेट किया गया एपीआई अब Conversation क्लास का इस्तेमाल करता है. इससे सूचनाओं के अलावा, ऐप्लिकेशन के कॉन्टेक्स्ट में भी कई काम किए जा सकते हैं. यह StatusBarNotification क्लास का इस्तेमाल करने की पिछली ज़रूरी शर्त की जगह ले लेगा.

डीबग कार मैसेंजर

Car Messenger को डीबग करने के बारे में ज़्यादा जानने के लिए, नीचे दिए गए सेक्शन देखें.

ब्लूटूथ कनेक्शन डीबग करना

  1. dumpsys कमांड चलाएं:

    adb shell dumpsys bluetooth_manager
    • dumpsys कमांड के आउटपुट में MapClientService खोजें.
     Profile: MapClientService
      mCurrentDevice: 99:99 (Pixel XL) name=Mce state=Connected

  2. पक्का करें कि सूची में सही डिवाइस शामिल हो. उदाहरण के लिए:

    डिवाइसों की सूची पांचवीं इमेज. डिवाइसों की सूची.

  3. अगर कोई डिवाइस नहीं मिलता है, तो इनमें से कोई एक तरीका अपनाएं:

    • ब्लूटूथ से फिर से कनेक्ट करें.

    या

    • ब्लूटूथ सेटिंग में जाकर,पुष्टि करें कि मैसेज चालू है.

    या

    • फ़ोन पर, पुष्टि करें कि मैसेज का ऐक्सेस दिया गया है.

ब्लूटूथ डेटाबेस डीबग करना

Car Messenger, टेलीफ़ोन डेटाबेस पर आधारित है. यह पता लगाने के लिए कि ब्लूटूथ से उस डेटाबेस में जानकारी अपने-आप भर रही है या नहीं, टेबल में दिए गए निर्देशों का इस्तेमाल किया जा सकता है.

टास्क निर्देश
बातचीत adb shell content query--uri content://mms-sms/conversations?simple=true
सिर्फ़ मैसेज (एसएमएस) adb shell content query--uri content://sms
मल्टीमीडिया मैसेज (एमएमएस)/मैसेज (एसएमएस) adb shell content query--uri content://mms-sms/conversations
सिर्फ़ मल्टीमीडिया मैसेज (एमएमएस) adb shell content query--uri content://mms
सिर्फ़ एमएमएस इनबॉक्स adb shell content query--uri content://mms/conversations/inbox
सिर्फ़ एसएमएस भेजे गए मैसेज adb shell content query--uri content://sms/sent
सिर्फ़ एसएमएस इनबॉक्स adb shell content query--uri content://sms/conversations/inbox
मल्टीमीडिया मैसेज (एमएमएस) का पहला हिस्सा
(1 की जगह मल्टीमीडिया मैसेज (एमएमएस) का आईडी डालें)		 adb shell content query--uri content://mms/part/1

कार मैसेंजर और आवाज़ से डिवाइस का इस्तेमाल करने वाली क्वेरी डीबग करना

अगर बिल्ड इमेज eng या userdebug है, तो लॉग डिफ़ॉल्ट रूप से प्रिंट हो जाते हैं. इसके अलावा, कार मैसेंजर के लिए लॉगिंग की सुविधा चालू करने के लिए:

  1. काम के टैग adb shell setprop log.tag.<TAG> DEBUG के लिए चलाएं.

  2. पहले से लोड की गई Assistant के लिए लॉगिंग की सुविधा चालू करें.

  3. बार-बार होने वाली गड़बड़ियों के लिए, Android Studio में ब्रेकपॉइंट इस्तेमाल करें.