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

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

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

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

শুরু করুন

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

ধারণা এবং বস্তু

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

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

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

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

অ্যান্ড্রয়েড অটোতে অ্যাপগুলিকে Notification Action অবজেক্ট যোগ করারও প্রয়োজন হয় যাতে ব্যবহারকারী কোনও বার্তার উত্তর দিতে পারেন অথবা গাড়ির ডিসপ্লে থেকে সরাসরি এটিকে পঠিত হিসেবে চিহ্নিত করতে পারেন।

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

বার্তা প্রবাহ

এই বিভাগটি আপনার অ্যাপ এবং অ্যান্ড্রয়েড অটোর মধ্যে একটি সাধারণ বার্তা প্রবাহ বর্ণনা করে।

  1. আপনার অ্যাপটি একটি বার্তা পায়।
  2. আপনার অ্যাপটি রিপ্লাই এবং মার্ক-অ্যাজ-রিড Action অবজেক্ট সহ একটি MessagingStyle বিজ্ঞপ্তি তৈরি করে।
  3. অ্যান্ড্রয়েড অটো অ্যান্ড্রয়েড সিস্টেম থেকে "নতুন বিজ্ঞপ্তি" ইভেন্টটি গ্রহণ করে এবং MessagingStyle , reply Action এবং mark-as-read Action খুঁজে পায়।
  4. অ্যান্ড্রয়েড অটো গাড়িতে একটি বিজ্ঞপ্তি তৈরি করে এবং প্রদর্শন করে।
  5. ব্যবহারকারী যদি গাড়ির ডিসপ্লেতে থাকা বিজ্ঞপ্তিটি ট্যাপ করেন, তাহলে Android Auto মার্ক-অ্যাজ-রিড Action ট্রিগার করে।
    • ব্যাকগ্রাউন্ডে, আপনার অ্যাপটিকে এই মার্ক-অ্যাজ-পঠিত ইভেন্টটি পরিচালনা করতে হবে।
  6. যদি ব্যবহারকারী ভয়েস ব্যবহার করে বিজ্ঞপ্তিতে সাড়া দেন, তাহলে অ্যান্ড্রয়েড অটো ব্যবহারকারীর প্রতিক্রিয়ার একটি ট্রান্সক্রিপশন রিপ্লাই 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>

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

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

AndroidX কোর লাইব্রেরি আমদানি করুন

অ্যান্ড্রয়েড অটো ব্যবহারের জন্য বিজ্ঞপ্তি তৈরি করতে অ্যান্ড্রয়েডএক্স কোর লাইব্রেরি প্রয়োজন। আপনার প্রকল্পে লাইব্রেরিটি নিম্নরূপ আমদানি করুন:

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

খাঁজকাটা 

allprojects {
    repositories {
        google()
    }
}

কোটলিন 

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

খাঁজকাটা 

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

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

কোটলিন 

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

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

ব্যবহারকারীর ক্রিয়াকলাপ পরিচালনা করুন

আপনার মেসেজিং অ্যাপের একটি 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, MessagingService ট্রিগারকারী Intent পেতে পারে না কারণ 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)
}

আপনি mark-as-read 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 অবজেক্টগুলি অন্যান্য অ্যাপে পাঠানো যেতে পারে। এইভাবে অ্যান্ড্রয়েড অটো কোনও কথোপকথনকে পঠিত হিসাবে চিহ্নিত করতে পারে বা উত্তর দিতে পারে।

একটি Action তৈরি করতে, একটি Intent দিয়ে শুরু করুন। নিম্নলিখিত উদাহরণে পূর্ববর্তী বিভাগ থেকে createReplyIntent() পদ্ধতি ব্যবহার করে কীভাবে একটি "reply" 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 সেট আপ করার আগে, জেনে রাখুন যে রিপ্লাই Action জন্য অ্যান্ড্রয়েড অটোর তিনটি প্রয়োজনীয়তা রয়েছে:

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

নিম্নলিখিত কোড নমুনাটি একটি reply 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 নেই। অতএব, মার্ক-অ্যাজ-রিড 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 এবং B: কথোপকথন A এর উত্তর আইডি হল 100, এবং এর মার্ক-অ্যাজ-পঠিত আইডি হল 101। কথোপকথন B এর উত্তর আইডি হল 102, এবং এর মার্ক-অ্যাজ-পঠিত আইডি হল 103। যদি কথোপকথন A আপডেট করা হয়, তাহলে উত্তর এবং মার্ক-অ্যাজ-পঠিত আইডিগুলি এখনও 100 এবং 101 থাকবে। আরও তথ্যের জন্য, PendingIntent.FLAG_UPDATE_CURRENT দেখুন।

একটি মেসেজিং স্টাইল তৈরি করুন

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 মেসেজিং বিজ্ঞপ্তির সমস্যার রিপোর্ট করুন

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

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

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