উইন্ডো অস্পষ্ট হয়ে যায়

Android 12-এ, উইন্ডো-ব্লার এফেক্ট প্রয়োগ করার জন্য পাবলিক API উপলভ্য, যেমন ব্যাকগ্রাউন্ড ব্লার এবং পিছনে ব্লার।

উইন্ডো ব্লার বা ক্রস-উইন্ডো ব্লার, প্রদত্ত উইন্ডোর পিছনের স্ক্রিন ব্লার করতে ব্যবহার করা হয়। দু'ধরনের উইন্ডো ব্লার আছে, যা বিভিন্ন ভিজ্যুয়াল এফেক্ট পেতে ব্যবহার করা যেতে পারে:

  • ব্যাকগ্রাউন্ড ব্লার আপনাকে ঝাপসা ব্যাকগ্রাউন্ড সহ উইন্ডো তৈরি করতে দেয়, যা ফ্রস্টেড গ্লাস এফেক্ট তৈরি করে।

  • পিছনে ব্লার করুন বিকল্পের সাহায্যে আপনি (ডায়ালগ) উইন্ডোর পিছনে পুরো স্ক্রিন ব্লার করতে পারবেন, যা ডেপ্থ অফ ফিল্ড এফেক্ট তৈরি করে।

নিচের ছবিতে দেখানো হয়েছে যে এই দুটি এফেক্ট আলাদাভাবে বা একসাথে ব্যবহার করা যেতে পারে:

শুধুমাত্র ব্যাকগ্রাউন্ড ব্লার

a

শুধুমাত্র পিছনে অস্পষ্ট করা

খ

ব্লার বিহাইন্ড ও ব্যাকগ্রাউন্ড ব্লার

c

ছবি ১. শুধুমাত্র ব্যাকগ্রাউন্ড অস্পষ্ট করা (ক), শুধুমাত্র পিছনের অংশ অস্পষ্ট করা (খ), ব্যাকগ্রাউন্ড ও পিছনের অংশ অস্পষ্ট করা (গ)

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

প্রয়োগ

অ্যাপ ডেভেলপার

অস্পষ্ট এফেক্ট তৈরি করতে অ্যাপ ডেভেলপারদের অবশ্যই অস্পষ্টতার ব্যাসার্ধ দিতে হবে। ব্লার কতটা ঘন হবে তা ব্লার রেডিয়াস কন্ট্রোল করে, অর্থাৎ, রেডিয়াস যত বেশি হবে, ব্লার তত ঘন হবে। ০ px ব্লার মানে কোনও ব্লার নেই। পিছনের অংশ ব্লার করার জন্য, ২০ px-এর ব্যাসার্ধ ফিল্ড এফেক্টের একটি ভাল গভীরতা তৈরি করে, যেখানে ৮০ px-এর ব্যাকগ্রাউন্ড ব্লার ব্যাসার্ধ একটি ভাল ফ্রস্টেড গ্লাস এফেক্ট তৈরি করে। ১৫০ px-এর বেশি ব্লার রেডিয়াস ব্যবহার করবেন না, কারণ এটি পারফর্ম্যান্সের উপর উল্লেখযোগ্য প্রভাব ফেলবে।

কাঙ্খিত ব্লার এফেক্ট পেতে এবং রিডেবিলিটি বাড়াতে, রঙের একটি ট্রান্সলুসেন্ট লেয়ার সহ একটি ব্লার রেডিয়াস ভ্যালু বেছে নিন।

ব্যাকগ্রাউন্ড অস্পষ্ট

ফ্লোটিং উইন্ডোতে উইন্ডো ব্যাকগ্রাউন্ড এফেক্ট তৈরি করতে ব্যাকগ্রাউন্ড ব্লার ব্যবহার করুন যা হল অন্তর্নিহিত কন্টেন্টের একটি ব্লার করা ছবি। আপনার উইন্ডোর জন্য অস্পষ্ট ব্যাকগ্রাউন্ড যোগ করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

  1. ব্যাকগ্রাউন্ড ব্লার রেডিয়াস সেট করতে Window#setBackgroundBlurRadius(int) কল করুন। অথবা, উইন্ডো থিমে, R.attr.windowBackgroundBlurRadius সেট করুন।

  2. উইন্ডোকে স্বচ্ছ করতে R.attr.windowIsTranslucent প্রপার্টিকে true হিসেবে সেট করুন। উইন্ডো সারফেসের নিচে ব্লার ড্র করা হয়, তাই ব্লার যাতে দেখা যায় তার জন্য উইন্ডোকে ট্রান্সলুসেন্ট হতে হবে।

  3. বিকল্প হিসেবে, Window#setBackgroundDrawableResource(int)-এ কল করে স্বচ্ছ রঙ সহ আয়তাকার উইন্ডো ব্যাকগ্রাউন্ড ড্রয়েবল যোগ করুন। অথবা, উইন্ডো থিমে, R.attr.windowBackground সেট করুন।

  4. গোলাকার কোণযুক্ত উইন্ডোর ক্ষেত্রে, উইন্ডো ব্যাকগ্রাউন্ড ড্রয়েবল হিসেবে গোলাকার কোণ সহ ShapeDrawable সেট করে অস্পষ্ট অংশের জন্য গোলাকার কোণ নির্ধারণ করুন।

  5. হ্যান্ডেল ব্লার চালু ও বন্ধ করার অবস্থা। আরও তথ্যের জন্য অ্যাপে উইন্ডো ব্লার ব্যবহার করার নির্দেশিকা বিভাগ দেখুন।

পিছনের অংশ অস্পষ্ট করা

'পিছনে ব্লার' বিকল্প উইন্ডোর পিছনে থাকা পুরো স্ক্রিন ব্লার করে দেয়। এই এফেক্ট ব্যবহার করে উইন্ডোর পিছনে স্ক্রিনে থাকা যেকোনও কিছু অস্পষ্ট করে উইন্ডোর কন্টেন্টের দিকে ব্যবহারকারীর মনোযোগ আকর্ষণ করা হয়।

আপনার উইন্ডোর পিছনের কন্টেন্ট অস্পষ্ট করতে, এইসব ধাপ অনুসরণ করুন:

  1. অস্পষ্ট করার সুবিধা চালু করতে, উইন্ডো ফ্ল্যাগে FLAG_BLUR_BEHIND যোগ করুন। অথবা, উইন্ডো থিমে, R.attr.windowBlurBehindEnabled সেট করুন।

  2. রেডিয়াসের পিছনে অস্পষ্টতা সেট করতে WindowManager.LayoutParams#setBlurBehindRadius কল করুন। অথবা, উইন্ডো থিমে, R.attr.windowBlurBehindRadius সেট করুন।

  3. বিকল্প হিসেবে, পরিপূরক ডিম অ্যামাউন্ট বেছে নিন।

  4. ব্লার চালু ও বন্ধ থাকা অবস্থা ম্যানেজ করুন। আরও তথ্যের জন্য অ্যাপে উইন্ডো ব্লার ব্যবহার করার নির্দেশিকা বিভাগ দেখুন।

অ্যাপে উইন্ডো ব্লার ব্যবহার করার নির্দেশিকা

উইন্ডো ব্লার করার সুবিধা নিম্নলিখিত বিষয়গুলির উপর নির্ভর করে:

  • Android ভার্সন: উইন্ডো ব্লার API শুধুমাত্র Android 12 ও তার পরবর্তী যেকোনও ভার্সনে উপলভ্য। Android ভার্সনের জন্য ডিভাইস SDK চেক করুন।

  • গ্রাফিক্স পারফর্ম্যান্স: কম পারফর্ম্যান্সের GPU সহ ডিভাইস উইন্ডো ব্লার সাপোর্ট না করার বিকল্প বেছে নিতে পারে।

  • সিস্টেমের অবস্থা: সিস্টেম সার্ভার রানটাইমে সাময়িকভাবে উইন্ডো ব্লার করার সুবিধা বন্ধ করে দিতে পারে। যেমন, ব্যাটারি সেভিং মোডে, নির্দিষ্ট ধরনের ভিডিও কন্টেন্ট চালানোর সময় অথবা ডেভেলপার ওভাররাইড করার কারণে।

Android-এর বিভিন্ন ভার্সন, ডিভাইস ও সিস্টেমের অবস্থা জুড়ে আপনার অ্যাপকে মানানসই করে তুলতে, এইসব নির্দেশিকা অনুসরণ করুন:

  • WindowManager#addCrossWindowBlurEnabledListener-এর মাধ্যমে একটি লিসনার যোগ করুন, যাতে উইন্ডো ব্লার চালু বা বন্ধ করা হলে আপনাকে বিজ্ঞপ্তি পাঠানো যায়। এছাড়াও, উইন্ডো ব্লার বর্তমানে চালু আছে কিনা তা জানতে WindowManager#isCrossWindowBlurEnabled ব্যবহার করুন।

  • উইন্ডো ব্যাকগ্রাউন্ডের জন্য দুটি ভার্সন প্রয়োগ করুন, যাতে উইন্ডো ব্লার চালু বা বন্ধ করা যায়।

    ব্লার চালু করা থাকলে, উইন্ডো ব্যাকগ্রাউন্ডকে ট্রান্সলুসেন্ট হতে হবে যাতে ব্লার দেখা যায়। এই অবস্থায়, ব্লার করার সুবিধা বন্ধ করে দেওয়া হলে, উইন্ডো কন্টেন্ট সরাসরি আন্ডারলায়িং উইন্ডোর কন্টেন্টের সাথে ওভারল্যাপ করে, এর ফলে ওভারল্যাপ করা উইন্ডোটি কম স্পষ্ট হয়ে যায়। এই ধরনের প্রভাব এড়াতে, উইন্ডো ব্লার বন্ধ করা থাকলে, নিম্নলিখিত উপায়ে অ্যাপের UI মানিয়ে নিন:

    • ব্যাকগ্রাউন্ড অস্পষ্ট করার জন্য, উইন্ডো ব্যাকগ্রাউন্ডের আলফা ভ্যালু ড্রয়েবল বাড়িয়ে দিন, এটি আরও অস্বচ্ছ হয়ে যাবে।

    • পিছনের অংশ ব্লার করতে, আরও বেশি ব্লার অ্যামাউন্ট সহ একটি হালকা লেয়ার যোগ করুন।

ব্যাকগ্রাউন্ড ব্লার ও পিছনে ব্লার করার উদাহরণ

এই বিভাগে এমন একটি অ্যাক্টিভিটির কার্যকরী উদাহরণ দেওয়া হয়েছে যা blur behind ও ব্যাকগ্রাউন্ড ব্লার, দুটিই ব্যবহার করে।

MainActivity.java-এর নিম্নলিখিত উদাহরণ হল ২০ px রেডিয়াসের পিছনে এবং ৮০ px ব্যাকগ্রাউন্ড ব্লার রেডিয়াসের ব্লার সহ একটি ডায়ালগ। এটির কোণগুলি গোলাকার, উইন্ডো ব্যাকগ্রাউন্ড ড্রয়েবলে xml-এ তা সংজ্ঞায়িত করা হয়েছে। এটি বিভিন্ন Android ভার্সন, বিভিন্ন ডিভাইস (যেগুলি সম্ভবত উইন্ডো ব্লার সাপোর্ট করে না) এবং রানটাইম ব্লার চালু বা বন্ধ করা সংক্রান্ত পরিবর্তন সঠিকভাবে হ্যান্ডেল করে। এটি নিশ্চিত করে যে ডায়ালগ কন্টেন্ট সেই শর্তগুলির যেকোনও একটির অধীনে উইন্ডো ব্যাকগ্রাউন্ড ড্রয়েবল আলফা এবং উইন্ডো ডিমের পরিমাণ অ্যাডজাস্ট করে পড়া যায়।

public class MainActivity extends Activity {

    private final int mBackgroundBlurRadius = 80;
    private final int mBlurBehindRadius = 20;

    // We set a different dim amount depending on whether window blur is enabled or disabled
    private final float mDimAmountWithBlur = 0.1f;
    private final float mDimAmountNoBlur = 0.4f;

    // We set a different alpha depending on whether window blur is enabled or disabled
    private final int mWindowBackgroundAlphaWithBlur = 170;
    private final int mWindowBackgroundAlphaNoBlur = 255;

    // Use a rectangular shape drawable for the window background. The outline of this drawable
    // dictates the shape and rounded corners for the window background blur area.
    private Drawable mWindowBackgroundDrawable;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mWindowBackgroundDrawable = getDrawable(R.drawable.window_background);
        getWindow().setBackgroundDrawable(mWindowBackgroundDrawable);

        if (buildIsAtLeastS()) {
            // Enable blur behind. This can also be done in xml with R.attr#windowBlurBehindEnabled
            getWindow().addFlags(WindowManager.LayoutParams.FLAG_BLUR_BEHIND);

            // Register a listener to adjust window UI whenever window blurs are enabled/disabled
            setupWindowBlurListener();
        } else {
            // Window blurs are not available prior to Android S
            updateWindowForBlurs(false /* blursEnabled */);
        }

        // Enable dim. This can also be done in xml, see R.attr#backgroundDimEnabled
        getWindow().addFlags(WindowManager.LayoutParams.FLAG_DIM_BEHIND);
    }

    /**
     * Set up a window blur listener.
     *
     * Window blurs might be disabled at runtime in response to user preferences or system states
     * (e.g. battery saving mode). WindowManager#addCrossWindowBlurEnabledListener allows to
     * listen for when that happens. In that callback we adjust the UI to account for the
     * added/missing window blurs.
     *
     * For the window background blur we adjust the window background drawable alpha:
     *     - lower when window blurs are enabled to make the blur visible through the window
     *       background drawable
     *     - higher when window blurs are disabled to ensure that the window contents are readable
     *
     * For window blur behind we adjust the dim amount:
     *     - higher when window blurs are disabled - the dim creates a depth of field effect,
     *       bringing the user's attention to the dialog window
     *     - lower when window blurs are enabled - no need for a high alpha, the blur behind is
     *       enough to create a depth of field effect
     */
    @RequiresApi(api = Build.VERSION_CODES.S)
    private void setupWindowBlurListener() {
        Consumer<Boolean> windowBlurEnabledListener = this::updateWindowForBlurs;
        getWindow().getDecorView().addOnAttachStateChangeListener(
                new View.OnAttachStateChangeListener() {
                    @Override
                    public void onViewAttachedToWindow(View v) {
                        getWindowManager().addCrossWindowBlurEnabledListener(
                                windowBlurEnabledListener);
                    }

                    @Override
                    public void onViewDetachedFromWindow(View v) {
                        getWindowManager().removeCrossWindowBlurEnabledListener(
                                windowBlurEnabledListener);
                    }
                });
    }

    private void updateWindowForBlurs(boolean blursEnabled) {
        mWindowBackgroundDrawable.setAlpha(blursEnabled && mBackgroundBlurRadius > 0 ?
                mWindowBackgroundAlphaWithBlur : mWindowBackgroundAlphaNoBlur);
        getWindow().setDimAmount(blursEnabled && mBlurBehindRadius > 0 ?
                mDimAmountWithBlur : mDimAmountNoBlur);

        if (buildIsAtLeastS()) {
            // Set the window background blur and blur behind radii
            getWindow().setBackgroundBlurRadius(mBackgroundBlurRadius);
            getWindow().getAttributes().setBlurBehindRadius(mBlurBehindRadius);
            getWindow().setAttributes(getWindow().getAttributes());
        }
    }

    private static boolean buildIsAtLeastS() {
        return Build.VERSION.SDK_INT >= Build.VERSION_CODES.S;
    }
}

উইন্ডোর কোণগুলি গোলাকার করতে, আমরা res/drawable/window_background.xml-এ উইন্ডো ব্যাকগ্রাউন্ডকে ShapeDrawable হিসেবে গোলাকার কোণ সহ রেডিয়াস ২০ dp হিসেবে নিম্নলিখিতভাবে ডিফাইন করি:

<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle" >
    <corners android:radius="20dp"/>
    <solid android:color="#AAAAAA"/>
</shape>

অ্যাক্টিভিটির নিচে থাকা উইন্ডোর কন্টেন্ট উইন্ডো ব্লার ব্লার করে দেয়। অস্পষ্ট করা ছবি এই অ্যাক্টিভিটি উইন্ডোর নিচে আঁকা হয়, তাই অস্পষ্ট করা ছবিকে দৃশ্যমান করার জন্য অ্যাক্টিভিটি উইন্ডোকে ট্রান্সলুসেন্ট হতে হবে। উইন্ডোটি ট্রান্সলুসেন্ট করতে আমরা অ্যাক্টিভিটি থিমে R.attr.windowIsTranslucent সেট করি, যা নিচে দেখানো হয়েছে:

<style name="Theme.BlurryDialog" parent="Theme.MaterialComponents.Dialog">
    <item name="android:windowIsTranslucent">true</item>
</style>

OEM ও পার্টনার

কোনও ডিভাইসে উইন্ডো ব্লার করার সুবিধা পেতে, OEM-কে ঘোষণা করতে হবে যে ডিভাইসটি উইন্ডো ব্লার করার সুবিধা সাপোর্ট করে।

আপনার ডিভাইসে উইন্ডো ব্লার কাজ করে কিনা তা চেক করতে, নিম্নলিখিতগুলি করুন:

  • ডিভাইসটি অতিরিক্ত GPU লোড সামলাতে পারবে কিনা তা নিশ্চিত করুন। কম দামের ডিভাইস অতিরিক্ত লোড সামলাতে নাও পারে, যার ফলে ফ্রেম ড্রপ হতে পারে। যথেষ্ট GPU পাওয়ার আছে এমন পরীক্ষিত ডিভাইসে শুধুমাত্র উইন্ডো ব্লার চালু করুন।

  • আপনার কাস্টমাইজ করা রেন্ডার ইঞ্জিন থাকলে, আপনার রেন্ডার ইঞ্জিন যে ব্লারিং লজিক প্রয়োগ করে তা নিশ্চিত করুন। ডিফল্ট Android 12 রেন্ডার ইঞ্জিন BlurFilter.cpp-এ ব্লার করার লজিক প্রয়োগ করে।

আপনার ডিভাইস উইন্ডো ব্লার সাপোর্ট করতে পারে কিনা তা নিশ্চিত করার পরে, নিম্নলিখিত সারফেস ফ্লিংগার sysprop সেট করুন:

PRODUCT_VENDOR_PROPERTIES += \
       ro.surface_flinger.supports_background_blur=1

যাচাইকরণ

আপনার অ্যাপ উইন্ডো যে ব্লার চালু ও ব্লার বন্ধ অবস্থার মধ্যে পরিবর্তন করার সময় সঠিকভাবে হ্যান্ডেল করে তা যাচাই করতে, এইসব ধাপ অনুসরণ করুন:

  1. UI খুলুন যাতে অস্পষ্টতা আছে।

  2. উইন্ডো ব্লার চালু ও বন্ধ করার মাধ্যমে উইন্ডো ব্লার চালু বা বন্ধ করুন।

  3. উইন্ডো UI প্রত্যাশিতভাবে অস্পষ্ট অবস্থা থেকে পরিবর্তিত হচ্ছে কিনা তা যাচাই করুন।

উইন্ডো ব্লার চালু ও বন্ধ করুন

উইন্ডো ব্লার এফেক্টের সাথে উইন্ডো UI কীভাবে রেন্ডার হয় তা পরীক্ষা করতে, নিম্নলিখিত পদ্ধতিগুলির মধ্যে একটি ব্যবহার করে ব্লার চালু বা বন্ধ করুন:

  • ডেভেলপার বিকল্প থেকে:

    সেটিংস -> সিস্টেম -> ডেভেলপার বিকল্প -> হার্ডওয়্যার অ্যাক্সিলারেটেড রেন্ডারিং -> উইন্ডো-লেভেল ব্লার করার অনুমতি দিন

  • রুট করা ডিভাইসের টার্মিনাল থেকে:

    adb shell wm disable-blur 1 # 1 disables window blurs, 0 allows them

আপনার Android 12+ ডিভাইসে উইন্ডো ব্লার করার সুবিধা আছে কিনা এবং বর্তমানে উইন্ডো ব্লার করার সুবিধা চালু আছে কিনা তা চেক করতে, রুট করা ডিভাইসে adb shell wm disable-blur রান করুন।

সমস্যার সমাধান

যাচাইকরণের সময় সমস্যা সমাধানের জন্য নিম্নলিখিত বিষয়গুলি নির্দেশিকা হিসেবে ব্যবহার করুন।

কোনও অস্পষ্টতা আঁকা হয়নি

  • বর্তমানে ব্লার চালু আছে কিনা এবং আপনার হার্ডওয়্যার এটি সাপোর্ট করে কিনা তা যাচাই করুন। উইন্ডো ব্লার চালু ও বন্ধ করা দেখুন।

  • নিশ্চিত করুন যে আপনি একটি স্বচ্ছ উইন্ডো ব্যাকগ্রাউন্ড কালার সেট করেছেন। একটি অস্বচ্ছ উইন্ডো ব্যাকগ্রাউন্ডের রঙ অস্পষ্ট এলাকা লুকিয়ে রাখে।

টেস্ট ডিভাইসে উইন্ডো ব্লার কাজ করে না

  • Android 12 এমুলেটরে আপনার অ্যাপ্লিকেশন পরীক্ষা করুন। Android এমুলেটর সেট-আপ করতে, Android এমুলেটর সেট-আপ করুন নিবন্ধটি দেখুন। এমুলেটর ব্যবহার করে তৈরি করা যেকোনও Android ভার্চুয়াল ডিভাইসে উইন্ডো ব্লার কাজ করে।

কোনও গোলাকার কোণ নেই

ডেভেলপার বিকল্প আপডেট করলে অস্পষ্টতা চালু হয় না

  • ডিভাইসটি ব্যাটারি সেভিং মোডে আছে কিনা অথবা এটি মাল্টিমিডিয়া টানেলিং ব্যবহার করছে কিনা তা চেক করুন। এছাড়াও, কিছু টিভি ডিভাইসে ভিডিও প্লেব্যাকের সময় উইন্ডো ব্লার করার সুবিধা বন্ধ করা হতে পারে।

ব্যাকগ্রাউন্ড ব্লার করার সুবিধাটি উইন্ডোর মধ্যে নয়, ফুলস্ক্রিনে ড্র করা হয়েছে

  • আপনার উইন্ডো ফ্লোটিং হিসেবে চিহ্নিত করা হয়েছে কিনা তা নিশ্চিত করতে android:windowIsFloating চেক করুন।

  • উইন্ডো ব্যাকগ্রাউন্ড ড্রয়েবল সেট করা আছে কিনা তা নিশ্চিত করুন। এই সেটিং অস্পষ্ট এলাকার আউটলাইন নির্ধারণ করে।

লিসনার থেকে পাওয়া আপডেট স্ক্রিনে প্রয়োগ করা হয় না

  • পুরনো উইন্ডো ইনস্ট্যান্সে লিসনার আপডেট প্রয়োগ করা হতে পারে। সঠিক লিসেনার আপডেটের মাধ্যমে উইন্ডোটি নষ্ট হয়ে আবার তৈরি হচ্ছে কিনা তা চেক করুন।