অ্যাপ-মধ্যস্থ 'এক ঝলকে' উইজেট পিন করা

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

পিন সংক্রান্ত অনুরোধ তৈরি করুন

উইজেট পিন করা শুরু করতে, GlanceAppWidgetManager ক্লাস থেকে requestPinGlanceAppWidget পদ্ধতি ব্যবহার করুন। Android-এর পুরনো ভার্সনে চলা অ্যাপের ক্ষেত্রে, এটি false রিটার্ন করে। তবে, সিস্টেমে অনুরোধটি সফলভাবে পাঠানো হলে, এটি true রিটার্ন করে।

আপনি কীভাবে পিন অনুরোধ তৈরি করতে পারেন তার একটি উদাহরণ এখানে দেওয়া হল:

@Composable
fun AnInAppComposable() {
    val context = LocalContext.current
    val coroutineScope = rememberCoroutineScope()
    Button(
        onClick = {
            coroutineScope.launch {
                GlanceAppWidgetManager(context).requestPinGlanceAppWidget(
                    receiver = MyWidgetReceiver::class.java,
                    preview = MyWidget(),
                    previewState = DpSize(245.dp, 115.dp)
                )
            }
        }
    ) {}
}
GlancePinAppWidget.kt

এই উদাহরণে, MyWidgetReceiver হল সেই ক্লাস যা উইজেটের কলব্যাক রিসিভ করে এবং MyWidget হল সেই Glance উইজেট যা আপনি পিন করতে চান। successCallback হল একটি PendingIntent যা উইজেটটি সফলভাবে পিন করা হলে ট্রিগার হয়।

পিন অনুরোধের উত্তর ম্যানেজ করুন

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

মনে রাখবেন, হোম স্ক্রিনে উইজেট যোগ করা হলে তবেই successCallback ট্রিগার করা হয়। ব্যবহারকারী অনুরোধ প্রত্যাখ্যান করলে বা লঞ্চার পিন করার সুবিধা না দিলে এটি ট্রিগার হয় না।