इमर्सिव मोड के लिए सिस्टम बार छिपाएं

कुछ कॉन्टेंट को फ़ुलस्क्रीन में देखने पर बेहतर अनुभव मिलता है. ऐसा करने पर, स्टेटस बार या नेविगेशन बार पर कोई इंडिकेटर नहीं दिखता. वीडियो, गेम, इमेज वाली गैलरी, किताबें, और प्रज़ेंटेशन स्लाइड, इस तरह के कॉन्टेंट के कुछ उदाहरण हैं. इसे इमर्सिव मोड कहा जाता है. इस पेज पर बताया गया है कि फ़ुलस्क्रीन में कॉन्टेंट दिखाकर, उपयोगकर्ताओं को ज़्यादा दिलचस्पी कैसे दिलाई जा सकती है.

पहली इमेज. इमर्सिव मोड का उदाहरण.

इमर्सिव मोड की मदद से, उपयोगकर्ता किसी गेम के दौरान अनजाने में बाहर निकलने से बच सकते हैं. साथ ही, इमेज, वीडियो, और किताबों को बेहतर तरीके से आनंद लिया जा सकता है. हालांकि, इस बात का ध्यान रखें कि उपयोगकर्ता सूचनाएं देखने, अचानक खोज करने या अन्य कार्रवाइयां करने के लिए, ऐप्लिकेशन में कितनी बार आते-जाते हैं. इमर्सिव मोड की वजह से, उपयोगकर्ताओं को सिस्टम नेविगेशन को आसानी से ऐक्सेस करने में समस्या होती है. इसलिए, इमर्सिव मोड का इस्तेमाल सिर्फ़ तब करें, जब उपयोगकर्ता अनुभव को बेहतर बनाने के लिए, स्क्रीन के अतिरिक्त स्पेस का इस्तेमाल करना ज़रूरी हो.

सिस्टम बार छिपाने के लिए, WindowInsetsControllerCompat.hide() का इस्तेमाल करें. इन्हें वापस लाने के लिए, WindowInsetsControllerCompat.show() का इस्तेमाल करें.

नीचे दिए गए स्निपेट में, सिस्टम बार को छिपाने और दिखाने के लिए बटन को कॉन्फ़िगर करने का उदाहरण दिया गया है.

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    ...

    val windowInsetsController =
        WindowCompat.getInsetsController(window, window.decorView)
    // Configure the behavior of the hidden system bars.
    windowInsetsController.systemBarsBehavior =
        WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE

    // Add a listener to update the behavior of the toggle fullscreen button when
    // the system bars are hidden or revealed.
    ViewCompat.setOnApplyWindowInsetsListener(window.decorView) { view, windowInsets ->
        // You can hide the caption bar even when the other system bars are visible.
        // To account for this, explicitly check the visibility of navigationBars()
        // and statusBars() rather than checking the visibility of systemBars().
        if (windowInsets.isVisible(WindowInsetsCompat.Type.navigationBars())
            || windowInsets.isVisible(WindowInsetsCompat.Type.statusBars())) {
            binding.toggleFullscreenButton.setOnClickListener {
                // Hide both the status bar and the navigation bar.
                windowInsetsController.hide(WindowInsetsCompat.Type.systemBars())
            }
        } else {
            binding.toggleFullscreenButton.setOnClickListener {
                // Show both the status bar and the navigation bar.
                windowInsetsController.show(WindowInsetsCompat.Type.systemBars())
            }
        }
        ViewCompat.onApplyWindowInsets(view, windowInsets)
    }
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
    ...

    WindowInsetsControllerCompat windowInsetsController =
            WindowCompat.getInsetsController(getWindow(), getWindow().getDecorView());
    // Configure the behavior of the hidden system bars.
    windowInsetsController.setSystemBarsBehavior(
            WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
    );

    // Add a listener to update the behavior of the toggle fullscreen button when
    // the system bars are hidden or revealed.
    ViewCompat.setOnApplyWindowInsetsListener(
        getWindow().getDecorView(),
        (view, windowInsets) -> {
        // You can hide the caption bar even when the other system bars are visible.
        // To account for this, explicitly check the visibility of navigationBars()
        // and statusBars() rather than checking the visibility of systemBars().
        if (windowInsets.isVisible(WindowInsetsCompat.Type.navigationBars())
                || windowInsets.isVisible(WindowInsetsCompat.Type.statusBars())) {
            binding.toggleFullscreenButton.setOnClickListener(v -> {
                // Hide both the status bar and the navigation bar.
                windowInsetsController.hide(WindowInsetsCompat.Type.systemBars());
            });
        } else {
            binding.toggleFullscreenButton.setOnClickListener(v -> {
                // Show both the status bar and the navigation bar.
                windowInsetsController.show(WindowInsetsCompat.Type.systemBars());
            });
        }
        return ViewCompat.onApplyWindowInsets(view, windowInsets);
    });
}

इसके अलावा, जब कोई उपयोगकर्ता उनसे इंटरैक्ट करता है, तो आपके पास यह तय करने का विकल्प होता है कि किस तरह के सिस्टम बार को छिपाया जाए और उनका व्यवहार तय किया जाए.

यह तय करना कि सिस्टम के कौनसे बार छिपाने हैं

छिपाने के लिए सिस्टम बार के टाइप की जानकारी देने के लिए, WindowInsetsControllerCompat.hide() में से किसी एक पैरामीटर को पास करें.

छिपे हुए सिस्टम बार के व्यवहार के बारे में बताना

WindowInsetsControllerCompat.setSystemBarsBehavior() का इस्तेमाल करके बताएं कि जब उपयोगकर्ता, छिपे हुए सिस्टम बार से इंटरैक्ट करता है, तो वह कैसा काम करता है.

  • WindowInsetsControllerCompat.BEHAVIOR_SHOW_BARS_BY_TOUCH का इस्तेमाल करके, डिसप्ले पर उपयोगकर्ता के किसी भी इंटरैक्शन पर छिपे हुए सिस्टम बार दिखाएं.

  • किसी भी सिस्टम जेस्चर पर छिपे हुए सिस्टम बार को दिखाने के लिए, WindowInsetsControllerCompat.BEHAVIOR_SHOW_BARS_BY_SWIPE का इस्तेमाल करें. जैसे, स्क्रीन के उस किनारे से स्वाइप करना जहां बार छिपा हुआ है.

  • सिस्टम जेस्चर की मदद से, छिपे हुए सिस्टम बार को कुछ समय के लिए दिखाने के लिए, WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE का इस्तेमाल करें. जैसे, स्क्रीन के उस किनारे से स्वाइप करना जहां से बार छिपाया गया है. ये ट्रांज़िशन सिस्टम बार, आपके ऐप्लिकेशन के कॉन्टेंट पर ओवरले होते हैं. इनमें कुछ हद तक पारदर्शिता हो सकती है. साथ ही, ये कुछ समय के लिए दिखने के बाद अपने-आप छिप जाते हैं.