জেনারেটেড উইজেট প্রিভিউ আপনাকে আপনার উইজেটগুলির জন্য গতিশীল, ব্যক্তিগতকৃত প্রিভিউ তৈরি করতে দেয় যা ব্যবহারকারীর হোম স্ক্রিনে কীভাবে প্রদর্শিত হবে তা সঠিকভাবে প্রতিফলিত করে। এগুলি একটি পুশ এপিআই এর মাধ্যমে সরবরাহ করা হয়, যার অর্থ আপনার অ্যাপটি উইজেট হোস্টের কাছ থেকে কোনও স্পষ্ট অনুরোধ না পেয়ে তার জীবনচক্রের যেকোনো সময়ে প্রিভিউ প্রদান করে।
এই নির্দেশিকাটিতে Glance-ভিত্তিক উইজেটগুলির জন্য প্রিভিউ কীভাবে প্রদান করতে হয় তা আলোচনা করা হয়েছে। যদি আপনার উইজেটটি RemoteViews এর সাথে বাস্তবায়িত হয়, তাহলে আপনার উইজেট পিকারে প্রিভিউ যোগ করুন দেখুন।
Glance উইজেটের জন্য আপনার অ্যাপের উইজেট পিকার অভিজ্ঞতা উন্নত করতে, Android 15 এবং পরবর্তী ডিভাইসগুলিতে GlanceAppWidget.providePreview ব্যবহার করে একটি জেনারেটেড উইজেট প্রিভিউ প্রদান করুন এবং পূর্ববর্তী সংস্করণগুলির জন্য একটি previewImage নির্দিষ্ট করুন, এবং যদি একটি জেনারেটেড প্রিভিউ উপলব্ধ না থাকে তবে Android 15+ এ একটি ফলব্যাক হিসাবে।
আরও তথ্যের জন্য, YouTube-এ লাইভ আপডেট এবং উইজেট দিয়ে আপনার অ্যাপকে সমৃদ্ধ করুন দেখুন।
জেনারেট করা উইজেট প্রিভিউয়ের জন্য আপনার অ্যাপ সেট আপ করুন
অ্যান্ড্রয়েড ১৫ বা তার পরবর্তী ডিভাইসে জেনারেটেড উইজেট প্রিভিউ দেখানোর জন্য, প্রথমে মডিউল build.gradle ফাইলে compileSdk মান ৩৫ বা তার পরবর্তী সেট করুন যাতে উইজেট পিকারে RemoteViews প্রদানের ক্ষমতা থাকে।
এরপর অ্যাপগুলি GlanceAppWidgetManager এ setWidgetPreview ব্যবহার করতে পারে। অপব্যবহার রোধ করতে এবং সিস্টেমের স্বাস্থ্য সংক্রান্ত উদ্বেগ কমাতে, setWidgetPreview হল একটি রেট-লিমিটেড API। ডিফল্ট সীমা হল প্রতি ঘন্টায় প্রায় দুটি কল।
Jetpack Glance ব্যবহার করে আপডেটেড প্রিভিউ তৈরি করুন
জেটপ্যাক গ্ল্যান্স দিয়ে তৈরি উইজেটগুলির জন্য, নিম্নলিখিতগুলি করুন:
প্রিভিউয়ের জন্য কম্পোজেবল কন্টেন্ট প্রদান করতে
GlanceAppWidget.providePreviewফাংশনটি ওভাররাইড করুন। যেমনটি আপনিprovideGlanceতে করবেন, আপনার অ্যাপের ডেটা লোড করুন এবং উইজেটের কন্টেন্ট কম্পোজেবলে পাঠান, যাতে প্রিভিউ সঠিক ডেটা দেখায়।provideGlanceবিপরীতে, এটি একটি একক কম্পোজিশন যার কোনও পুনর্গঠন বা প্রভাব নেই।প্রিভিউ তৈরি এবং প্রকাশ করতে
GlanceAppWidgetManager.setWidgetPreviewsএ কল করুন।
প্রিভিউ প্রদানের জন্য সিস্টেম থেকে কোনও কলব্যাক নেই, তাই আপনার অ্যাপকে কখন setWidgetPreviews কল করতে হবে তা নির্ধারণ করতে হবে। আপডেট কৌশল আপনার উইজেটের ব্যবহারের ক্ষেত্রে নির্ভর করে:
- যদি উইজেটে স্ট্যাটিক তথ্য থাকে অথবা এটি একটি দ্রুত পদক্ষেপ, তাহলে অ্যাপটি প্রথম চালু হওয়ার সময় প্রিভিউ সেট করুন।
- আপনার অ্যাপে ডেটা আসার পর আপনি প্রিভিউ সেট করতে পারেন; উদাহরণস্বরূপ, ব্যবহারকারীর সাইন-ইন বা প্রাথমিক সেটআপের পরে।
- আপনি একটি নির্বাচিত ক্যাডেন্সে প্রিভিউ আপডেট করার জন্য একটি পর্যায়ক্রমিক টাস্ক সেট আপ করতে পারেন।
জেনারেট করা প্রিভিউগুলির সমস্যা সমাধান করুন
একটি সাধারণ সমস্যা হল, প্রিভিউ তৈরি করার পরে, উইজেটের ড্রপ সাইজের তুলনায় প্রিভিউ ইমেজ থেকে ছবি, আইকন বা অন্যান্য কম্পোজেবল অনুপস্থিত থাকতে পারে। এই ড্রপ সাইজটি targetCellWidth এবং targetCellHeight দ্বারা নির্ধারিত হয়, যদি নির্দিষ্ট করা থাকে, অথবা অ্যাপ উইজেট প্রোভাইডার ইনফো ফাইলে minWidth এবং minHeight দ্বারা নির্ধারিত হয়।
এটি ঘটে কারণ অ্যান্ড্রয়েড, ডিফল্টভাবে, শুধুমাত্র উইজেটের সর্বনিম্ন আকারে দৃশ্যমান কম্পোজেবলগুলিকে রেন্ডার করে। অন্য কথায়, অ্যান্ড্রয়েড ডিফল্টরূপে previewSizeMode কে SizeMode.Single এ সেট করে। এটি কোন কম্পোজেবলগুলি আঁকতে হবে তা নির্ধারণ করতে অ্যাপ উইজেট প্রোভাইডার ইনফো XML- এ android:minHeight এবং android:minWidth ব্যবহার করে।
এটি ঠিক করার জন্য, আপনার GlanceAppWidget এ previewSizeMode ওভাররাইড করুন এবং SizeMode.Responsive এ সেট করুন, যা DpSize মানের একটি সেট প্রদান করে। এটি Android কে প্রিভিউয়ের জন্য রেন্ডার করার জন্য প্রয়োজনীয় সমস্ত লেআউট আকার সম্পর্কে অবহিত করে, যা নিশ্চিত করে যে সমস্ত উপাদান সঠিকভাবে প্রদর্শিত হচ্ছে।
নির্দিষ্ট ফর্ম ফ্যাক্টরের জন্য অপ্টিমাইজ করুন। ন্যূনতম থেকে শুরু করে এবং আপনার উইজেটের ব্রেকপয়েন্ট অনুসরণ করে এক বা দুটি আকার সরবরাহ করুন। ব্যাকওয়ার্ড সামঞ্জস্যের জন্য কমপক্ষে একটি previewImage নির্দিষ্ট করুন। আপনি উইজেট ডিজাইন নির্দেশিকাতে বিভিন্ন গ্রিড আকারের জন্য উপযুক্ত ন্যূনতম ডিপি মান খুঁজে পেতে পারেন।
উইজেট প্রিভিউয়ের সাথে পিছনের দিকে সামঞ্জস্যপূর্ণতা
Android 15 এর চেয়ে কম ভার্সনে চলমান ডিভাইসগুলিতে উইজেট পিকারদের আপনার উইজেটের প্রিভিউ দেখাতে দিতে, অথবা Android 15+ এ জেনারেটেড প্রিভিউয়ের জন্য ফলব্যাক হিসেবে, previewImage বৈশিষ্ট্যটি নির্দিষ্ট করুন।
আপনি যদি উইজেটের চেহারা পরিবর্তন করেন, তাহলে প্রিভিউ ইমেজ আপডেট করুন।