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

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

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

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

WindowInsetsControllerCompat.hide() का इस्तेमाल करें और WindowInsetsControllerCompat.show() को छिपाने के लिए ताकि उन्हें वापस लाया जा सके.

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

KotlinJava
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)
    }
}
 
@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 का इस्तेमाल करें. जैसे, स्क्रीन के उस किनारे से स्वाइप करना जहां बार छिपा है. ये अस्थायी सिस्टम बार, आपके ऐप्लिकेशन के कॉन्टेंट को ओवरले करते हैं. इसमें पारदर्शिता के साथ-साथ, छोटे टाइम आउट के बाद अपने-आप छिप जाते हैं.