अपने ऐप्लिकेशन को फ़ोल्ड करें

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

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

विंडो की जानकारी

Jetpack Compose में, विंडो के फ़ोल्ड होने की जानकारी देखने के लिए, collectFoldingFeaturesAsState() कंपोज़ेबल फ़ंक्शन का इस्तेमाल करें. collectFoldingFeaturesAsState(), WindowInfoTracker से मौजूदा विंडो के फ़ोल्डिंग फ़ीचर इकट्ठा करता है. इसके बाद, उन्हें Compose State में डालता है. इसमें FoldingFeature ऑब्जेक्ट की सूची होती है.

collectFoldingFeaturesAsState(), Compose State दिखाता है. इसलिए, जब भी डिवाइस के फ़ोल्ड होने की स्थिति या पॉस्चर में बदलाव होता है, तो आपके कंपोज़ेबल अपने-आप फिर से कंपोज़ हो जाते हैं. इसके लिए, मैन्युअल तरीके से लाइफ़साइकल मैनेजमेंट या फ़्लो कलेक्शन की ज़रूरत नहीं होती:

@Composable
fun FoldAwareScreen() {
    val foldingFeatures by collectFoldingFeaturesAsState()

    // Access folding features for the current window.
    val foldFeature = foldingFeatures.firstOrNull()
    if (foldFeature != null) {
        // Adapt layout based on the fold feature.
    }
}

फ़ोल्ड किए जा सकने वाले डिसप्ले की सुविधाएं

collectFoldingFeaturesAsState() (DisplayFeature का सब-टाइप) से मिले FoldingFeature एलिमेंट की सूची से, फ़ोल्ड किए जा सकने वाले डिसप्ले के बारे में जानकारी मिलती है. इसमें ये प्रॉपर्टी शामिल हैं:

  • state: डिवाइस के फ़ोल्ड होने की स्थिति, FLAT या HALF_OPENED

  • orientation: फ़ोल्ड या हिंज का ओरिएंटेशन, HORIZONTAL या VERTICAL

  • occlusionType: क्या फ़ोल्ड या हिंज, डिसप्ले के किसी हिस्से को छिपाता है, NONE या FULL

  • isSeparating: फ़ोल्ड या हिंज की वजह से दो लॉजिकल डिसप्ले एरिया बनते हैं या नहीं, सही या गलत

फ़ोल्ड किए जा सकने वाले डिवाइस के लिए, HALF_OPENED हमेशा isSeparating को true के तौर पर रिपोर्ट करता है, क्योंकि स्क्रीन को दो डिसप्ले एरिया में बांटा गया है. साथ ही, जब ऐप्लिकेशन दोनों स्क्रीन पर फैला हो, तो ड्यूअल-स्क्रीन डिवाइस पर isSeparating हमेशा सही होता है.

FoldingFeature bounds प्रॉपर्टी (DisplayFeature से इनहेरिट की गई), फ़ोल्ड या हिंज जैसी फ़ोल्डिंग सुविधा के बाउंडिंग रेक्टैंगल को दिखाती है. बाउंड का इस्तेमाल, स्क्रीन पर एलिमेंट को सुविधा के हिसाब से पोज़िशन करने के लिए किया जा सकता है:

@Composable
fun FoldFeatureDemo() {
    val foldingFeatures by collectFoldingFeaturesAsState()
    val foldFeature = foldingFeatures.firstOrNull()

    if (foldFeature != null) {
        val isSeparating = foldFeature.isSeparating
        val occlusionType = foldFeature.occlusionType
        val bounds = foldFeature.bounds
        // Use bounds and properties to position content.
    }
}

टेबलटॉप पॉस्चर

FoldingFeature ऑब्जेक्ट में शामिल जानकारी का इस्तेमाल करके, आपका ऐप्लिकेशन टेबलटॉप जैसे पॉस्चर के साथ काम कर सकता है. इसमें फ़ोन किसी सतह पर रखा होता है, हिंज हॉरिज़ॉन्टल पोज़िशन में होता है, और फ़ोल्ड की जा सकने वाली स्क्रीन आधी खुली होती है.

टेबलटॉप मोड की मदद से, उपयोगकर्ता अपने फ़ोन को हाथ में पकड़े बिना ही उसे आसानी से इस्तेमाल कर सकते हैं. टेबलटॉप पॉस्चर, मीडिया देखने, फ़ोटो लेने, और वीडियो कॉल करने के लिए बेहतरीन है.

टेबलटॉप पॉस्चर में वीडियो प्लेयर ऐप्लिकेशन. इसमें स्क्रीन के ऊपर वाले वर्टिकल हिस्से में वीडियो चलाया जा रहा है और नीचे वाले हॉरिज़ॉन्टल हिस्से में प्लेबैक कंट्रोल दिख रहे हैं.
पहली इमेज. टेबलटॉप पॉस्चर में वीडियो प्लेयर ऐप्लिकेशन—स्क्रीन के वर्टिकल हिस्से पर वीडियो और हॉरिज़ॉन्टल हिस्से पर प्लेबैक कंट्रोल.

collectFoldingFeaturesAsState() से FoldingFeature.State और FoldingFeature.Orientation का इस्तेमाल करके, यह पता लगाएं कि डिवाइस टेबलटॉप मोड में है या नहीं:

@Composable
fun TabletopContent() {
    val foldingFeatures by collectFoldingFeaturesAsState()
    val foldFeature = foldingFeatures.firstOrNull()

    val isTableTopPosture = foldFeature != null &&
        foldFeature.state == FoldingFeature.State.HALF_OPENED &&
        foldFeature.orientation == FoldingFeature.Orientation.HORIZONTAL

    if (isTableTopPosture) {
        // Tabletop layout: separate content and controls across the fold.
    } else {
        // Standard layout.
    }
}

इसके अलावा, यह भी पता लगाया जा सकता है कि विंडो टेबलटॉप पॉस्चर में है या नहीं. इसके लिए, currentWindowAdaptiveInfoV2() से मिली Posture प्रॉपर्टी को देखें:

val adaptiveInfo = currentWindowAdaptiveInfoV2()
val isTabletop = adaptiveInfo.windowPosture.isTabletop

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

उदाहरण

किताब की तरह

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

इसका इस्तेमाल फ़ोटोग्राफ़ी के लिए भी किया जा सकता है. ऐसा तब किया जा सकता है, जब आपको हाथ का इस्तेमाल किए बिना फ़ोटो लेते समय, अलग आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) कैप्चर करना हो.

बुक पॉस्चर को लागू करने के लिए, टेबलटॉप पॉस्चर वाली तकनीकों का इस्तेमाल करें. देखें कि फ़ोल्ड करने की सुविधा का ओरिएंटेशन, हॉरिज़ॉन्टल के बजाय वर्टिकल हो:

@Composable
fun BookContent() {
    val foldingFeatures by collectFoldingFeaturesAsState()
    val foldFeature = foldingFeatures.firstOrNull()

    val isBookPosture = foldFeature != null &&
        foldFeature.state == FoldingFeature.State.HALF_OPENED &&
        foldFeature.orientation == FoldingFeature.Orientation.VERTICAL

    if (isBookPosture) {
        // Book posture layout: two-page layout across the vertical fold.
    } else {
        // Standard single-page layout.
    }
}

विंडो के साइज़ में बदलाव

डिवाइस के कॉन्फ़िगरेशन में बदलाव होने पर, ऐप्लिकेशन के डिसप्ले एरिया में बदलाव हो सकता है. उदाहरण के लिए, जब डिवाइस को फ़ोल्ड या अनफ़ोल्ड किया जाता है, घुमाया जाता है या मल्टी-विंडो मोड में उसका साइज़ बदला जाता है.

Jetpack Compose में, मौजूदा विंडो साइज़ क्लास को वापस पाने और साइज़ में हुए बदलावों के हिसाब से अडजस्ट करने के लिए, Compose Material 3 Adaptive लाइब्रेरी से currentWindowAdaptiveInfoV2() कंपोज़ेबल फ़ंक्शन का इस्तेमाल करें. currentWindowAdaptiveInfoV2() WindowAdaptiveInfo इंस्टेंस दिखाता है, जो मौजूदा विंडो का WindowSizeClass उपलब्ध कराता है. इसमें डिफ़ॉल्ट रूप से, बड़े और बहुत बड़े ब्रेकपॉइंट के लिए सहायता शामिल होती है. साथ ही, यह डिवाइस का windowPosture भी उपलब्ध कराता है:

@Composable
fun AdaptiveApp() {
    val adaptiveInfo = currentWindowAdaptiveInfoV2()
    val windowSizeClass = adaptiveInfo.windowSizeClass

    when {
        windowSizeClass.isWidthAtLeastBreakpoint(
            WIDTH_DP_EXPANDED_LOWER_BOUND
        ) -> {
            // Expanded layout
        }
        windowSizeClass.isWidthAtLeastBreakpoint(
            WIDTH_DP_MEDIUM_LOWER_BOUND
        ) -> {
            // Medium layout
        }
        else -> {
            // Compact layout
        }
    }
}

विंडो साइज़ क्लास का इस्तेमाल करना लेख पढ़ें.

अन्य संसाधन

फ़ोल्ड किए जा सकने वाले डिवाइसों और उनके लिए उपलब्ध लेआउट के बारे में ज़्यादा जानने के लिए, ये संसाधन देखें:

सैंपल

  • Jetpack WindowManager का सैंपल: Jetpack WindowManager लाइब्रेरी को इस्तेमाल करने का उदाहरण
  • Jetcaster: Compose की मदद से, टेबलटॉप पोस्चर को लागू करना

कोडलैब