Android Auto-তে মেসেজিং বিজ্ঞপ্তি এক্সটেন্ড করুন

description: MessagingStyle API ব্যবহার করে Android Auto-তে মেসেজিং বিজ্ঞপ্তি এক্সটেন্ড করুন। keywords_public: Android Auto,মেসেজিং বিজ্ঞপ্তি,MessagingStyle,NotificationCompat.Action,কমিউনিকেশন অ্যাপ,গাড়ির ডেভেলপমেন্ট,IntentService,RemoteInput,PendingIntent

মেসেজিং অ্যাপগুলি তাদের মেসেজিং বিজ্ঞপ্তিগুলি প্রসারিত করতে পারে যাতে Android Auto যখন চলছে তখন সেগুলি ব্যবহার করতে পারে। Android Auto-এর মাধ্যমে এইসব বিজ্ঞপ্তি দেখানো হয় এবং ব্যবহারকারীদের কম বিভ্রান্তিকর ইন্টারফেসে মেসেজ পড়তে ও উত্তর দিতে দেয়। এবং আপনি MessagingStyle API ব্যবহার করলে, Android Auto সহ সব Android ডিভাইসের জন্য অপ্টিমাইজ করা মেসেজ বিজ্ঞপ্তি পাবেন। অপ্টিমাইজেশনের মধ্যে রয়েছে মেসেজ বিজ্ঞপ্তির জন্য বিশেষভাবে তৈরি UI, উন্নত অ্যানিমেশন এবং ইনলাইন ছবির জন্য সহায়তা।

এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে কীভাবে এমন একটি অ্যাপের কার্যকারিতা বাড়ানো যায় যা ব্যবহারকারীকে মেসেজ দেখায় এবং ব্যবহারকারীর উত্তর গ্রহণ করে, যেমন একটি চ্যাট অ্যাপ, যাতে মেসেজ দেখানো এবং উত্তরের রসিদ Android Auto-তে পাঠানো যায়। এই ইন্টিগ্রেশনের মাধ্যমে, ব্যবহারকারীরা শুধুমাত্র তাদের অ্যাক্টিভ Android Auto সেশন চলাকালীন প্রাপ্ত বিজ্ঞপ্তি থেকে মেসেজের ইতিহাস দেখতে পারবেন। অ্যাক্টিভ Android Auto সেশন শুরু হওয়ার আগে থেকে মেসেজ দেখাতে, আপনি টেমপ্লেট করা মেসেজিং অভিজ্ঞতা তৈরি করতে পারেন।

ডিজাইন সংক্রান্ত নির্দেশিকার জন্য, Design for Cars হাবে কমিউনিকেশন অ্যাপ দেখুন।

শুরু করুন

Android Auto-র জন্য মেসেজিং পরিষেবা প্রদান করতে, আপনার অ্যাপকে অবশ্যই ম্যানিফেস্টে Android Auto-র জন্য এর সমর্থন ঘোষণা করতে হবে এবং নিম্নলিখিতগুলি করতে সক্ষম হতে হবে:

ধারণা ও অবজেক্ট

আপনার অ্যাপ ডিজাইন করা শুরু করার আগে, Android Auto কীভাবে মেসেজিং ম্যানেজ করে তা বুঝে নেওয়া সহায়ক হবে।

যোগাযোগের একটি স্বতন্ত্র অংশকে মেসেজ বলা হয় এবং এটি MessagingStyle.Message ক্লাস দ্বারা উপস্থাপিত হয়। মেসেজে প্রেরকের নাম, মেসেজের কন্টেন্ট এবং মেসেজ পাঠানোর সময় উল্লেখ করা থাকে।

ব্যবহারকারীদের মধ্যে যোগাযোগকে কথোপকথন বলা হয় এবং এটি MessagingStyle অবজেক্ট দ্বারা দেখানো হয়। একটি কথোপকথন বা MessagingStyle-এ একটি শীর্ষক, মেসেজ এবং কথোপকথনটি ব্যবহারকারীদের একটি গ্রুপের মধ্যে কিনা তা অন্তর্ভুক্ত থাকে।

কোনও কথোপকথনে আপডেট সম্পর্কে ব্যবহারকারীদের জানাতে, যেমন নতুন মেসেজ, অ্যাপ Android সিস্টেমে একটি Notification পোস্ট করে। এই Notification, বিজ্ঞপ্তি শেডে মেসেজিং-নির্দিষ্ট UI দেখানোর জন্য MessagingStyle অবজেক্ট ব্যবহার করে। Android প্ল্যাটফর্মও এই Notification Android Auto-তে পাস করে এবং গাড়ির ডিসপ্লেতে বিজ্ঞপ্তি পোস্ট করার জন্য MessagingStyle এক্সট্র্যাক্ট করে ব্যবহার করা হয়।

এছাড়াও, Android Auto-এর ক্ষেত্রে অ্যাপকে Action অবজেক্ট Notification-এ যোগ করতে হয় যাতে ব্যবহারকারী সরাসরি গাড়ির ডিসপ্লে থেকে মেসেজের উত্তর দিতে বা সেটি পড়া হয়েছে হিসেবে চিহ্নিত করতে পারেন।

সংক্ষেপে, একটি কথোপকথন Notification অবজেক্ট দ্বারা উপস্থাপিত হয় যা MessagingStyle অবজেক্টের সাথে স্টাইল করা হয়। MessagingStyle-এ এক বা একাধিক MessagingStyle.Message অবজেক্টে সেই কথোপকথনের মধ্যে থাকা সব মেসেজ থাকে। এছাড়াও, Android Auto-এর সাথে মানানসই হতে, কোনও অ্যাপকে অবশ্যই Notification-এ উত্তর এবং পড়া-হয়ে-গেছে-হিসেবে-চিহ্নিত-করুন Action অবজেক্ট অ্যাটাচ করতে হবে।

মেসেজিং ফ্লো

এই বিভাগে আপনার অ্যাপ ও Android Auto-এর মধ্যে মেসেজিংয়ের সাধারণ ফ্লো বর্ণনা করা হয়েছে।

  1. আপনার অ্যাপ একটি মেসেজ পায়।
  2. আপনার অ্যাপ উত্তর ও পড়া-হয়ে-গেছে-হিসেবে-চিহ্নিত-করুন Action অবজেক্ট সহ MessagingStyle বিজ্ঞপ্তি তৈরি করে।
  3. Android Auto, Android সিস্টেম থেকে "নতুন বিজ্ঞপ্তি" ইভেন্ট পায় এবং MessagingStyle, উত্তর Action ও 'পড়া হয়েছে' হিসেবে চিহ্নিত করুন Action বিকল্প খুঁজে পায়।
  4. Android Auto গাড়িতে বিজ্ঞপ্তি তৈরি করে দেখায়।
  5. ব্যবহারকারী গাড়ির ডিসপ্লেতে বিজ্ঞপ্তিতে ট্যাপ করলে, Android Auto 'পড়া হয়েছে হিসেবে চিহ্নিত করুন' Action ট্রিগার করে।
    • ব্যাকগ্রাউন্ডে, আপনার অ্যাপকে অবশ্যই এই 'পড়া হয়েছে হিসেবে চিহ্নিত করুন' ইভেন্ট ম্যানেজ করতে হবে।
  6. ব্যবহারকারী ভয়েস ব্যবহার করে বিজ্ঞপ্তির উত্তর দিলে, Android Auto ব্যবহারকারীর উত্তরের ট্রান্সক্রিপশন উত্তরে Action যোগ করে এবং তারপরে এটি ট্রিগার করে।
    • ব্যাকগ্রাউন্ডে, আপনার অ্যাপকে অবশ্যই এই উত্তর ইভেন্ট ম্যানেজ করতে হবে।

প্রাথমিক অনুমান

এই পৃষ্ঠাটি আপনাকে সম্পূর্ণ মেসেজিং অ্যাপ তৈরি করার ব্যাপারে গাইড করে না। নিম্নলিখিত কোড স্যাম্পেলে এমন কিছু জিনিস অন্তর্ভুক্ত আছে যা Android Auto-এর সাথে মেসেজিং সাপোর্ট শুরু করার আগে আপনার অ্যাপের প্রয়োজন:

data class YourAppConversation(
        val id: Int,
        val title: String,
        val recipients: MutableList<YourAppUser>,
        val icon: Bitmap) {
    companion object {
        /** Fetches [YourAppConversation] by its [id]. */
        fun getById(id: Int): YourAppConversation = // ...
    }

    /** Replies to this conversation with the given [message]. */
    fun reply(message: String) {}

    /** Marks this conversation as read. */
    fun markAsRead() {}

    /** Retrieves all unread messages from this conversation. */
    fun getUnreadMessages(): List<YourAppMessage> { return /* ... */ }
}
data class YourAppUser(val id: Int, val name: String, val icon: Uri)
data class YourAppMessage(
    val id: Int,
    val sender: YourAppUser,
    val body: String,
    val timeReceived: Long)

Android Auto সাপোর্ট ঘোষণা করুন

Android Auto কোনও মেসেজিং অ্যাপ থেকে বিজ্ঞপ্তি পেলে, এটি চেক করে দেখে যে অ্যাপটি Android Auto-এর জন্য সহায়তা ঘোষণা করেছে কিনা। এই সহায়তা চালু করতে, আপনার অ্যাপের ম্যানিফেস্টে নিম্নলিখিত এন্ট্রি অন্তর্ভুক্ত করুন:

<application>
    ...
    <meta-data
        android:name="com.google.android.gms.car.application"
        android:resource="@xml/automotive_app_desc"/>
    ...
</application>

এই ম্যানিফেস্ট এন্ট্রি অন্য একটি XML ফাইল, automotive_app_desc.xml-কে রেফার করে, যা আপনাকে অ্যাপ মডিউলের res/xml ডিরেক্টরি-তে তৈরি করতে হবে। automotive_app_desc.xml-এ, আপনার অ্যাপ যেসব Android Auto ফিচার সাপোর্ট করে সেগুলি ঘোষণা করুন। বিজ্ঞপ্তির জন্য সহায়তা ঘোষণা করতে, নিম্নলিখিতগুলি অন্তর্ভুক্ত করুন:

<automotiveApp>
    <uses name="notification" />
</automotiveApp>

আপনার অ্যাপ ডিফল্ট এসএমএস হ্যান্ডলার হিসেবে সেট করা গেলে, নিম্নলিখিত <uses> এলিমেন্ট অন্তর্ভুক্ত করতে ভুলবেন না। আপনি তা না করলে, আপনার অ্যাপ ডিফল্ট এসএমএস হ্যান্ডলার হিসেবে সেট করা থাকলে, ইনকামিং এসএমএস/এমএমএস মেসেজ ম্যানেজ করার জন্য Android Auto তার বিল্ট-ইন ডিফল্ট হ্যান্ডলার ব্যবহার করে, যার ফলে ডুপ্লিকেট বিজ্ঞপ্তি আসতে পারে।

<automotiveApp>
    ...
    <uses name="sms" />
</automotiveApp>

AndroidX কোর লাইব্রেরি ইমপোর্ট করুন

Android Auto-র সাথে ব্যবহার করার জন্য বিজ্ঞপ্তি তৈরি করতে AndroidX কোর লাইব্রেরি প্রয়োজন। আপনার প্রোজেক্টে লাইব্রেরি ইমপোর্ট করতে এই ধাপগুলি অনুসরণ করুন:

  1. টপ-লেভেল build.gradle ফাইলে, Google-এর Maven রিপোজিটরির উপর নির্ভরতা অন্তর্ভুক্ত করুন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

গ্ৰুভি

allprojects {
    repositories {
        google()
    }
}

Kotlin

allprojects {
    repositories {
        google()
    }
}
  1. আপনার অ্যাপ মডিউলের build.gradle ফাইলে, AndroidX Core লাইব্রেরি ডিপেন্ডেন্সি অন্তর্ভুক্ত করুন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

গ্ৰুভি

dependencies {
    // If your app is written in Java
    implementation 'androidx.core:core:1.19.1'

    // If your app is written in Kotlin
    implementation 'androidx.core:core-ktx:1.19.1'
}

Kotlin

dependencies {
    // If your app is written in Java
    implementation("androidx.core:core:1.19.1")

    // If your app is written in Kotlin
    implementation("androidx.core:core-ktx:1.19.1")
}

ব্যবহারকারীর অ্যাকশন ম্যানেজ করা

আপনার মেসেজিং অ্যাপে Action-এর মাধ্যমে কথোপকথন আপডেট করার সুবিধা থাকতে হবে। Android Auto-এর জন্য, আপনার অ্যাপকে দুই ধরনের Action অবজেক্ট ম্যানেজ করতে হয়: উত্তর দেওয়া এবং 'পড়া হয়েছে' হিসেবে চিহ্নিত করা। আমরা সাজেস্ট করি যে আপনি এগুলি IntentService ব্যবহার করে ম্যানেজ করুন, যা আপনার অ্যাপের মূল থ্রেডকে মুক্ত করে, ব্যাকগ্রাউন্ডে সম্ভাব্য ব্যয়বহুল কল ম্যানেজ করার সুবিধা প্রদান করে।

ইনটেন্ট অ্যাকশন নির্দিষ্ট করুন

Intent অ্যাকশন হল আপনার বেছে নেওয়া বেসিক স্ট্রিং যা Intent কীসের জন্য তা শনাক্ত করে। যেহেতু একটি পরিষেবা একাধিক ধরনের ইনটেন্ট ম্যানেজ করতে পারে, তাই একাধিক IntentService কম্পোনেন্ট সংজ্ঞায়িত করার পরিবর্তে একাধিক অ্যাকশন স্ট্রিং সংজ্ঞায়িত করা সহজ।

এই গাইডের উদাহরণ মেসেজিং অ্যাপে দুই ধরনের প্রয়োজনীয় অ্যাকশন আছে: উত্তর দেওয়া এবং 'পড়া হয়েছে' হিসেবে চিহ্নিত করা, যেমন নিম্নলিখিত কোড স্যাম্পেলে দেখানো হয়েছে:

private const val ACTION_REPLY = "com.example.REPLY"
private const val ACTION_MARK_AS_READ = "com.example.MARK_AS_READ"

পরিষেবা তৈরি করুন

এইসব Action অবজেক্ট ম্যানেজ করে এমন পরিষেবা তৈরি করতে, আপনার কথোপকথন আইডি প্রয়োজন, যা আপনার অ্যাপের মাধ্যমে নির্ধারিত একটি স্বেচ্ছাধীন ডেটা স্ট্রাকচার যা কথোপকথন শনাক্ত করে। এছাড়াও, আপনার একটি রিমোট ইনপুট কী প্রয়োজন হবে, যা এই বিভাগে পরে বিস্তারিতভাবে আলোচনা করা হয়েছে। নিম্নলিখিত কোড স্যাম্পেল প্রয়োজনীয় অ্যাকশন ম্যানেজ করার জন্য একটি পরিষেবা তৈরি করে:

private const val EXTRA_CONVERSATION_ID_KEY = "conversation_id"
private const val REMOTE_INPUT_RESULT_KEY = "reply_input"

/**
 * An [IntentService] that handles reply and mark-as-read actions for
 * [YourAppConversation]s.
 */
class MessagingService : IntentService("MessagingService") {
    override fun onHandleIntent(intent: Intent?) {
        // Fetches internal data.
        val conversationId = intent!!.getIntExtra(EXTRA_CONVERSATION_ID_KEY, -1)

        // Searches the database for that conversation.
        val conversation = YourAppConversation.getById(conversationId)

        // Handles the action that was requested in the intent. The TODOs
        // are addressed in a later section.
        when (intent.action) {
            ACTION_REPLY -> TODO()
            ACTION_MARK_AS_READ -> TODO()
        }
    }
}

আপনার অ্যাপের সাথে এই পরিষেবা যুক্ত করতে, আপনাকে অ্যাপের ম্যানিফেস্টে পরিষেবাটি রেজিস্টার করতে হবে, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

<application>
    <service android:name="com.example.MessagingService" />
    ...
</application>

ইনটেন্ট তৈরি ও ম্যানেজ করা

Android Auto সহ অন্যান্য অ্যাপ Intent পেতে পারে না যা MessagingService ট্রিগার করে কারণ ইনটেন্ট PendingIntent-এর মাধ্যমে অন্যান্য অ্যাপে পাস করা হয়। এই সীমাবদ্ধতার কারণে, আপনার অ্যাপে অন্যান্য অ্যাপকে উত্তর টেক্সট প্রদান করার অনুমতি দিতে একটি RemoteInput অবজেক্ট তৈরি করুন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

/**
 * Creates a [RemoteInput] that lets remote apps provide a response string
 * to the underlying [Intent] within a [PendingIntent].
 */
fun createReplyRemoteInput(context: Context): RemoteInput {
    // RemoteInput.Builder accepts a single parameter: the key to use to store
    // the response in.
    return RemoteInput.Builder(REMOTE_INPUT_RESULT_KEY).build()
    // Note that the RemoteInput has no knowledge of the conversation. This is
    // because the data for the RemoteInput is bound to the reply Intent using
    // static methods in the RemoteInput class.
}

/** Creates an [Intent] that handles replying to the given [appConversation]. */
fun createReplyIntent(
        context: Context, appConversation: YourAppConversation): Intent {
    // Creates the intent backed by the MessagingService.
    val intent = Intent(context, MessagingService::class.java)

    // Lets the MessagingService know this is a reply request.
    intent.action = ACTION_REPLY

    // Provides the ID of the conversation that the reply applies to.
    intent.putExtra(EXTRA_CONVERSATION_ID_KEY, appConversation.id)

    return intent
}

MessagingService-এর মধ্যে ACTION_REPLY সুইচ ক্লজে, Intent উত্তরে যে তথ্য যাবে তা এক্সট্র্যাক্ট করুন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

ACTION_REPLY -> {
    // Extracts reply response from the intent using the same key that the
    // RemoteInput uses.
    val results: Bundle = RemoteInput.getResultsFromIntent(intent)
    val message = results.getString(REMOTE_INPUT_RESULT_KEY)

    // This conversation object comes from the MessagingService.
    conversation.reply(message)
}

আপনি একই পদ্ধতিতে Intent-কে 'পড়া হয়েছে' হিসেবে চিহ্নিত করার বিষয়টি ম্যানেজ করেন। তবে, নিম্নলিখিত উদাহরণের মতো, এটির জন্য RemoteInput-এর প্রয়োজন নেই:

/** Creates an [Intent] that handles marking the [appConversation] as read. */
fun createMarkAsReadIntent(
        context: Context, appConversation: YourAppConversation): Intent {
    val intent = Intent(context, MessagingService::class.java)
    intent.action = ACTION_MARK_AS_READ
    intent.putExtra(EXTRA_CONVERSATION_ID_KEY, appConversation.id)
    return intent
}

MessagingService-এর মধ্যে ACTION_MARK_AS_READ সুইচ ক্লজের জন্য আর কোনও লজিকের প্রয়োজন নেই, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

// Marking as read has no other logic.
ACTION_MARK_AS_READ -> conversation.markAsRead()

মেসেজ সম্পর্কে ব্যবহারকারীদের বিজ্ঞপ্তি পাঠান

কথোপকথন অ্যাকশন ম্যানেজ করা সম্পূর্ণ হলে, পরবর্তী ধাপ হল Android Auto-এর সাথে মানানসই বিজ্ঞপ্তি তৈরি করা।

অ্যাকশন তৈরি করুন

আসল অ্যাপে পদ্ধতি ট্রিগার করতে Notification ব্যবহার করে Action অবজেক্ট অন্যান্য অ্যাপে পাস করা যেতে পারে। এইভাবে Android Auto কোনও কথোপকথনকে পড়া হয়েছে হিসেবে চিহ্নিত করতে বা সেটির উত্তর দিতে পারে।

Action তৈরি করতে, Intent দিয়ে শুরু করুন। আগের বিভাগ থেকে createReplyIntent() পদ্ধতি ব্যবহার করে কীভাবে "উত্তর" Intent তৈরি করতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

fun createReplyAction(
        context: Context, appConversation: YourAppConversation): Action {
    val replyIntent: Intent = createReplyIntent(context, appConversation)
    // ...

তারপর, এই Intent-কে PendingIntent-এ র‍্যাপ করুন, যা এটিকে এক্সটার্নাল অ্যাপ ব্যবহারের জন্য প্রস্তুত করে। PendingIntent, র‍্যাপ করা Intent-এর সমস্ত অ্যাক্সেস লক করে দেয়, শুধুমাত্র বেছে নেওয়া কিছু পদ্ধতি প্রকাশ করে, যার মাধ্যমে রিসিভ করা অ্যাপ Intent ফায়ার করতে পারে অথবা অরিজিনেট করা অ্যাপের প্যাকেজের নাম পেতে পারে। এক্সটার্নাল অ্যাপ, আন্ডারলাইন করা Intent বা এর মধ্যে থাকা ডেটা অ্যাক্সেস করতে পারবে না।

    // ...
    val replyPendingIntent = PendingIntent.getService(
        context,
        createReplyId(appConversation), // Method explained later.
        replyIntent,
        PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_MUTABLE)
    // ...

Action উত্তর সেট-আপ করার আগে, মনে রাখবেন যে Android Auto-তে Action উত্তরের জন্য তিনটি প্রয়োজনীয়তা রয়েছে:

  • সিম্যান্টিক অ্যাকশন অবশ্যই Action.SEMANTIC_ACTION_REPLY-এ সেট করতে হবে।
  • Action-এ উল্লেখ থাকতে হবে যে ফায়ার করার সময় এটি কোনও ইউজার ইন্টারফেস দেখাবে না।
  • Action-এ অবশ্যই একটি RemoteInput থাকতে হবে।

নিম্নলিখিত কোড স্যাম্পেল একটি উত্তর Action সেট-আপ করে যা আগে তালিকাভুক্ত করা প্রয়োজনীয়তা পূরণ করে:

    // ...
    val replyAction = Action.Builder(R.drawable.reply, "Reply", replyPendingIntent)
        // Provides context to what firing the Action does.
        .setSemanticAction(Action.SEMANTIC_ACTION_REPLY)

        // The action doesn't show any UI, as required by Android Auto.
        .setShowsUserInterface(false)

        // Don't forget the reply RemoteInput. Android Auto will use this to
        // make a system call that will add the response string into
        // the reply intent so it can be extracted by the messaging app.
        .addRemoteInput(createReplyRemoteInput(context))
        .build()

    return replyAction
}

'পড়া হয়েছে হিসেবে চিহ্নিত করুন' অ্যাকশনটি ম্যানেজ করাও একই রকম, শুধু RemoteInput নেই। তাই, Android Auto-তে 'পড়া হয়েছে হিসেবে চিহ্নিত করুন' Action-এর জন্য দুটি প্রয়োজনীয়তা রয়েছে:

  • সিম্যান্টিক অ্যাকশন Action.SEMANTIC_ACTION_MARK_AS_READ-এ সেট করা হয়েছে।
  • অ্যাকশন থেকে বোঝা যায় যে এটি ফায়ার করা হলে কোনও ইউজার ইন্টারফেস দেখাবে না।

নিম্নলিখিত কোড স্যাম্পেল 'পড়া হয়েছে হিসেবে চিহ্নিত করুন' Action সেট-আপ করে যা এইসব প্রয়োজনীয়তা পূরণ করে:

fun createMarkAsReadAction(
        context: Context, appConversation: YourAppConversation): Action {
    val markAsReadIntent = createMarkAsReadIntent(context, appConversation)
    val markAsReadPendingIntent = PendingIntent.getService(
            context,
            createMarkAsReadId(appConversation), // Method explained later.
            markAsReadIntent,
            PendingIntent.FLAG_UPDATE_CURRENT  or PendingIntent.FLAG_IMMUTABLE)
    val markAsReadAction = Action.Builder(
            R.drawable.mark_as_read, "Mark as Read", markAsReadPendingIntent)
        .setSemanticAction(Action.SEMANTIC_ACTION_MARK_AS_READ)
        .setShowsUserInterface(false)
        .build()
    return markAsReadAction
}

আপনি পেন্ডিং ইনটেন্ট জেনারেট করার সময় দুটি পদ্ধতি ব্যবহার করেন: createReplyId এবং createMarkAsReadId। এইসব পদ্ধতি প্রতিটি PendingIntent-এর জন্য অনুরোধ কোড হিসেবে কাজ করে, যা Android-এর মাধ্যমে আগে থেকে থাকা পেন্ডিং ইনটেন্ট নিয়ন্ত্রণ করতে ব্যবহার করা হয়। create পদ্ধতি অবশ্যই প্রতিটি কথোপকথনের জন্য অনন্য আইডি রিটার্ন করবে, তবে একই কথোপকথনের জন্য বারবার কল করলে, আগে থেকে জেনারেট করা অনন্য আইডি রিটার্ন করতে হবে।

দুটি কথোপকথন, ক এবং খ-এর উদাহরণ বিবেচনা করুন: কথোপকথন ক-এর উত্তর আইডি হল ১০০ এবং এর 'পড়া হয়েছে হিসেবে চিহ্নিত করুন' আইডি হল ১০১। কথোপকথন খ-এর উত্তর আইডি হল ১০২ এবং এটির 'পঠিত হিসেবে চিহ্নিত করুন' আইডি হল ১০৩। কথোপকথন A আপডেট করা হলে, উত্তর এবং পড়া-হয়ে-গেছে-হিসেবে-চিহ্নিত-করুন আইডি এখনও ১০০ এবং ১০১। আরও তথ্যের জন্য, PendingIntent.FLAG_UPDATE_CURRENT দেখুন।

MessagingStyle তৈরি করুন

MessagingStyle হল মেসেজিং তথ্যের বাহক এবং Android Auto এটি ব্যবহার করে কথোপকথনের প্রতিটি মেসেজ জোরে পড়ে।

প্রথমে, আপনাকে ডিভাইসের ব্যবহারকারীকে Person অবজেক্ট হিসেবে নির্দিষ্ট করতে হবে, যেমন নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

fun createMessagingStyle(
        context: Context, appConversation: YourAppConversation): MessagingStyle {
    // Method defined by the messaging app.
    val appDeviceUser: YourAppUser = getAppDeviceUser()

    val devicePerson = Person.Builder()
        // The display name (also the name that's read aloud in Android auto).
        .setName(appDeviceUser.name)

        // The icon to show in the notification shade in the system UI (outside
        // of Android Auto).
        .setIcon(appDeviceUser.icon)

        // A unique key in case there are multiple people in this conversation with
        // the same name.
        .setKey(appDeviceUser.id)
        .build()
    // ...

তারপর আপনি MessagingStyle অবজেক্ট তৈরি করতে এবং কথোপকথন সম্পর্কে কিছু বিবরণ দিতে পারবেন।

    // ...
    val messagingStyle = MessagingStyle(devicePerson)

    // Sets the conversation title. If the app's target version is lower
    // than P, this will automatically mark the conversation as a group (to
    // maintain backward compatibility). Use `setGroupConversation` after
    // setting the conversation title to explicitly override this behavior. See
    // the documentation for more information.
    messagingStyle.setConversationTitle(appConversation.title)

    // Group conversation means there is more than 1 recipient, so set it as such.
    messagingStyle.setGroupConversation(appConversation.recipients.size > 1)
    // ...

সবশেষে, না পড়া মেসেজ যোগ করুন।

    // ...
    for (appMessage in appConversation.getUnreadMessages()) {
        // The sender is also represented using a Person object.
        val senderPerson = Person.Builder()
            .setName(appMessage.sender.name)
            .setIcon(appMessage.sender.icon)
            .setKey(appMessage.sender.id)
            .build()

        // Adds the message. More complex messages, like images,
        // can be created and added by instantiating the MessagingStyle.Message
        // class directly. See documentation for details.
        messagingStyle.addMessage(
                appMessage.body, appMessage.timeReceived, senderPerson)
    }

    return messagingStyle
}

বিজ্ঞপ্তি প্যাকেজ ও পুশ করুন

Action এবং MessagingStyle অবজেক্ট তৈরি করার পরে, আপনি Notification তৈরি করে পোস্ট করতে পারবেন।

fun notify(context: Context, appConversation: YourAppConversation) {
    // Creates the actions and MessagingStyle.
    val replyAction = createReplyAction(context, appConversation)
    val markAsReadAction = createMarkAsReadAction(context, appConversation)
    val messagingStyle = createMessagingStyle(context, appConversation)

    // Creates the notification.
    val notification = NotificationCompat.Builder(context, channel)
        // A required field for the Android UI.
        .setSmallIcon(R.drawable.notification_icon)

        // Shows in Android Auto as the conversation image.
        .setLargeIcon(appConversation.icon)

        // Adds MessagingStyle.
        .setStyle(messagingStyle)

        // Adds reply action.
        .addAction(replyAction)

        // Makes the mark-as-read action invisible, so it doesn't appear
        // in the Android UI but the app satisfies Android Auto's
        // mark-as-read Action requirement. Both required actions can be made
        // visible or invisible; it is a stylistic choice.
        .addInvisibleAction(markAsReadAction)

        .build()

    // Posts the notification for the user to see.
    val notificationManagerCompat = NotificationManagerCompat.from(context)
    notificationManagerCompat.notify(appConversation.id, notification)
}

অতিরিক্ত রিসোর্স

Android Auto-র মেসেজিং বিজ্ঞপ্তি সংক্রান্ত সমস্যার ব্যাপারে অভিযোগ জানানো

Android Auto-এর জন্য মেসেজিং বিজ্ঞপ্তি ডেভেলপ করার সময় কোনও সমস্যা হলে, আপনি Google Issue Tracker ব্যবহার করে সেই বিষয়ে অভিযোগ জানাতে পারেন। সমস্যা সংক্রান্ত টেমপ্লেটে অনুরোধ করা সব তথ্য পূরণ করতে ভুলবেন না।

নতুন সমস্যা তৈরি করুন

নতুন কোনও সমস্যা সম্পর্কে অভিযোগ জানানোর আগে, সেটি আগে থেকেই সমস্যার তালিকায় রিপোর্ট করা আছে কিনা তা চেক করে নিন। ট্র্যাকারে কোনও সমস্যার জন্য স্টারে ক্লিক করে আপনি সাবস্ক্রাইব করতে এবং সমস্যার জন্য ভোট দিতে পারেন। আরও তথ্যের জন্য, কোনও সংখ্যা সাবস্ক্রাইব করা দেখুন।