फ़ोल्ड किए जा सकने वाले डिवाइसों पर टेबलटॉप पॉस्चर, एक स्क्रीन को दो फ़ंक्शनल डिसप्ले एरिया में बांट देता है. ये एरिया, फ़िज़िकल फ़ोल्ड (या हिंज) से अलग होते हैं. टेबलटॉप पोस्चर की मदद से, ऐप्लिकेशन के मुख्य कॉन्टेंट (जैसे, वीडियो प्लेयर या गेम कैनवस) को स्क्रीन के ऊपरी हिस्से पर रखा जा सकता है. वहीं, इंटरैक्टिव एलिमेंट (जैसे, मीडिया कंट्रोल या कंट्रोल पैड) को स्क्रीन के निचले हिस्से पर रखा जा सकता है.
सबसे सही तरीके
अपने ऐप्लिकेशन में टेबलटॉप मोड की सुविधा जोड़ने के लिए, Grid एपीआई का इस्तेमाल करें. इससे दो लाइनों और एक कॉलम वाला लेआउट तय किया जा सकता है. साथ ही, टेबलटॉप विंडो पॉस्चर मीडिया क्वेरी लागू की जा सकती है.
- डिवाइस के टेबलटॉप पॉस्चर का पता लगाना: डिवाइस की स्थिति देखने के लिए,
mediaQueryकंपोज़ेबल का इस्तेमाल करें. जब डिवाइस को टेबलटॉप पॉस्चर (windowPosture == Posture.Tabletop) में फ़ोल्ड किया जाता है, तो लेआउट को डाइनैमिक तरीके से शिफ़्ट करें. इसके लिए, गतिविधि को रीस्टार्ट करने या लाइफ़साइकल को मैनेज करने की ज़रूरत नहीं होती. Gridकी मदद से लेआउट को स्ट्रक्चर करें: टेबलटॉप पोस्चर में,Gridएपीआई (2 rows,1 column) का इस्तेमाल करें. इससे, मुख्य विज़ुअल कॉन्टेंट को फ़ोल्ड के ऊपर वाली लाइन में और इंटरैक्टिव कंट्रोल को फ़ोल्ड के नीचे वाली लाइन में साफ़ तौर पर अलग किया जा सकता है.- ओवरले के लिए, इंप्लिसिट z-इंडेक्सिंग का इस्तेमाल करें: स्टैंडर्ड (नॉन-टेबलटॉप) पॉस्चर में, एक ही सेल को कई एरिया आईडी असाइन करें, ताकि प्लेयर पर कंट्रोल ओवरले किए जा सकें.
Grid, आइटम को उनके एलान के क्रम में, अपने-आप पीछे से आगे की ओर रेंडर करता है. - स्मूद ट्रांज़िशन उपलब्ध कराना: पक्का करें कि स्टैंडर्ड फ़ुल-स्क्रीन लेआउट और टेबलटॉप पॉस्चर के बीच ट्रांज़िशन करते समय, स्टेट और स्क्रोल की पोज़िशन सुरक्षित रहें.
सामग्री
Grid: यह एक अडैप्टिव लेआउट कंटेनर है. इसकी मदद से, आइटम को कॉन्फ़िगर की जा सकने वाली लाइनों और कॉलम में रखा जा सकता है. यह स्क्रीन के अलग-अलग हिस्सों में कॉन्टेंट को बांटने के लिए सबसे सही है.mediaQuery: यह Jetpack Compose API है. इसका इस्तेमाल, सीधे कंपोज़ेबल में ऐप्लिकेशन की मौजूदा विंडो के पॉस्चर, साइज़ क्लास, और हार्डवेयर की विशेषताओं के बारे में क्वेरी करने के लिए किया जाता है.
चरण
mediaQuery() का इस्तेमाल करके, डिवाइस के पॉस्चर के बारे में क्वेरी करना. जब डिवाइस टेबलटॉप पॉस्चर में हो, तब अपने ऐप्लिकेशन के कॉन्टेंट को दो लाइन और एक कॉलम वाले वर्टिकल ग्रिड में व्यवस्थित करें. इससे यह पक्का किया जा सकेगा कि मुख्य कॉन्टेंट सबसे ऊपर दिखे और कंट्रोल सबसे नीचे ऐक्सेस किए जा सकें.
1. टेबलटॉप मोड के लिए ग्रिड कॉन्फ़िगरेशन तय करना
ऐप्लिकेशन बनाने की सुविधा में, enum का इस्तेमाल करके लेआउट एरिया के आईडी तय करें. साथ ही, डिफ़ॉल्ट और टेबलटॉप पॉस्चर के लिए GridConfigurationScope ब्लॉक सेट अप करें.
defaultConfig में, दोनों एरिया एक ही सेल (row = 1, column = 1) को असाइन किए जाते हैं. Grid, इंप्लिसिट z-इंडेक्सिंग का इस्तेमाल करता है. इसमें लेआउट में बाद में एलान किए गए कंपोज़ेबल, पहले वाले कंपोज़ेबल के ऊपर रेंडर होते हैं. इससे कंट्रोलर, बिना किसी अतिरिक्त कंटेनर नेस्टिंग के प्लेयर को ओवरले कर सकता है. ज़्यादा जानकारी के लिए, ग्रिड की मदद से यूज़र इंटरफ़ेस (यूआई) एलिमेंट ओवरले करना देखें.
enum class VideoPlayerArea { Player, Controller } object PlayerGridConfig { // Default: Single area layout with overlay (controls on top of player) val defaultConfig: GridConfigurationScope.() -> Unit = { row(1f) column(1f) area(areaId = VideoPlayerArea.Player, row = 1, column = 1) area(areaId = VideoPlayerArea.Controller, row = 1, column = 1) } // Tabletop: Two rows splitting content across the fold val tabletopConfig: GridConfigurationScope.() -> Unit = { row(0.5f) row(0.5f) column(1f) area(areaId = VideoPlayerArea.Player, row = 1, column = 1) // Top half above fold area(areaId = VideoPlayerArea.Controller, row = 2, column = 1) // Bottom half below fold } }
2. टेबलटॉप पॉस्चर का पता लगाना और ग्रिड में कॉन्फ़िगरेशन लागू करना
mediaQuery का इस्तेमाल करके, windowPosture के आधार पर ऐक्टिव कॉन्फ़िगरेशन चुनें. इसके बाद, config को Grid में पास करें और कंपोज़ेबल कॉन्टेंट को एरिया आईडी से बाइंड करें. VideoPlayerArea.Controller से पहले VideoPlayerArea.Player को डिक्लेयर करने से यह पक्का होता है कि जब दोनों defaultConfig में एक सेल शेयर करते हैं, तो कंट्रोल, प्लेयर के ऊपर रेंडर होते हैं:
val config = mediaQuery { when (windowPosture) { Posture.Tabletop -> PlayerGridConfig.tabletopConfig else -> PlayerGridConfig.defaultConfig } } Grid(config = config) { Box( modifier = Modifier .gridItem(areaId = VideoPlayerArea.Player) ) { // VideoPlayerContent } Box( modifier = Modifier .gridItem(areaId = VideoPlayerArea.Controller) ) { // PlaybackControlsContent } }
नतीजे
mediaQuery और Grid को जोड़कर, आपका ऐप्लिकेशन डाइनैमिक तौर पर यह पता लगाता है कि फ़ोल्ड किए जा सकने वाले डिवाइस को कब टेबलटॉप पॉस्चर में आधा फ़ोल्ड किया गया है. साथ ही, यह अपने-आप यूज़र इंटरफ़ेस (यूआई) को दो फ़ंक्शनल डिसप्ले एरिया में अडजस्ट कर देता है. ये दोनों एरिया, फ़ोल्ड से अलग होते हैं.
अन्य संसाधन
- अडैप्टिव ऐप्लिकेशन का इस्तेमाल शुरू करना
- फ़ोल्ड किए जा सकने वाले डिसप्ले मोड के साथ काम करना
- ग्रिड के साथ यूज़र इंटरफ़ेस (यूआई) एलिमेंट ओवरले