बड़ी स्क्रीन पर ऐप्लिकेशन के काम करने से जुड़ी सेटअप गाइड

इस पेज पर, Android की बड़ी स्क्रीन वाले डिवाइसों पर ऐप्लिकेशन के साथ काम करने की सुविधा को कॉन्फ़िगर करने के लिए, पूरी सेटअप गाइड और इंडेक्स दिया गया है.

डिसप्ले

इस सेक्शन में, कॉन्फ़िगरेशन की उन सभी सेटिंग की सूची दी गई है जिनका असर डिसप्ले लेवल के कॉन्फ़िगरेशन पर पड़ता है.

नाम जगह की जानकारी टाइप डिफ़ॉल्ट
ignoreOrientationRequest display_settings.xml कॉन्फ़िगरेशन false
true बड़ी स्क्रीन (>= 600dp) के लिए
ब्यौरा
इस सेटिंग की मदद से, तय ओरिएंटेशन वाली गतिविधियों को तय किए गए डिसप्ले पर रोटेट किया जा सकता है.
उदाहरण: 
          <display-settings>
              <config identifier="0" />
              <display
                  name="<display's uniqueId>"
                  ignoreOrientationRequest="true"/>
          </display-settings>

इस्तेमाल का उदाहरण या संदर्भ
डिस्प्ले, सभी ऐप्लिकेशन के लिए अनुरोध किए गए ओरिएंटेशन को अनदेखा करता है. साथ ही, ऐप्लिकेशन लेटरबॉक्स होता है.
इसका इस्तेमाल, बड़ी स्क्रीन वाले सभी डिवाइसों और Android Automotive OS पर किया जाता है. Android 16 और इसके बाद के वर्शन वाले सभी बड़ी स्क्रीन वाले डिवाइसों के लिए, यह डिफ़ॉल्ट रूप से smallestScreenWidthDp >= 600dp पर सेट होता है.
config_letterboxIsDisplayRotationImmersiveAppCompatPolicyEnabled frameworks/base/core/res/res/values/config.xml Bool false
ब्यौरा
यह इमर्सिव ऐप्लिकेशन के लिए, रोटेशन से जुड़ी नीति को चालू करता है. इससे फ़ुलस्क्रीन मोड में, स्क्रीन के अपने-आप ऐसे ओरिएंटेशन में रोटेट होने से रोका जा सकता है जो सबसे सही नहीं है. ऐसा करना इसलिए ज़रूरी है, क्योंकि गेम जैसे इमर्सिव ऐप्लिकेशन, अक्सर सभी ओरिएंटेशन के लिए ऑप्टिमाइज़ नहीं किए जाते हैं. साथ ही, रोटेट करने पर इनका यूज़र एक्सपीरियंस (यूएक्स) खराब हो सकता है. इसके अलावा, कुछ गेम खेलने के लिए सेंसर पर निर्भर होते हैं. इसलिए, अपने-आप स्क्रीन रोटेट होने की सुविधा चालू होने पर, उपयोगकर्ता गलती से स्क्रीन रोटेट कर सकते हैं.
यह सिर्फ़ तब लागू होता है, जब ignoreOrientationRequest चालू हो.

इस्तेमाल का उदाहरण या संदर्भ
इमर्सिव ऐप्लिकेशन के लिए रोटेशन लॉक करता है.

आसपेक्ट रेशियो

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

नाम जगह की जानकारी टाइप डिफ़ॉल्ट
config_fixedOrientationLetterboxAspectRatio frameworks/base/core/res/res/values/config.xml Float 0.0
ब्यौरा
इससे फ़िक्स्ड ओरिएंटेशन के लिए लेटरबॉक्सिंग का आसपेक्ट रेशियो कॉन्फ़िगर किया जाता है. 1.0 से कम या इसके बराबर वैल्यू को अनदेखा किया जाता है.

इस्तेमाल का उदाहरण या कॉन्टेक्स्ट
यह डिवाइस के डिफ़ॉल्ट आसपेक्ट रेशियो को कॉन्फ़िगर करता है. यह रेशियो, लेटरबॉक्स वाले ज़्यादातर ऐप्लिकेशन के साथ काम करता है. आम तौर पर, स्क्वेयर आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) के ज़्यादा करीब होता है.
config_letterboxIsSplitScreenAspectRatioForUnresizableAppsEnabled frameworks/base/core/res/res/values/config.xml Bool false
ब्यौरा
इस सेटिंग से यह कॉन्फ़िगर किया जाता है कि स्प्लिट-स्क्रीन के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) को, साइज़ बदलने की सुविधा के बिना काम करने वाले ऐप्लिकेशन के लिए डिफ़ॉल्ट आसपेक्ट रेशियो के तौर पर इस्तेमाल करना है या नहीं.

इस्तेमाल का उदाहरण या संदर्भ
साइज़ बदलने की सुविधा के बिना काम करने वाले ज़्यादातर ऐप्लिकेशन, पोर्ट्रेट कैंडीबार फ़ोन लेआउट के साथ काम करते हैं.
config_letterboxIsDisplayAspectRatioForFixedOrientationLetterboxEnabled frameworks/base/core/res/res/values/config.xml Bool false
ब्यौरा
यह कॉन्फ़िगर करता है कि लेटरबॉक्स वाले सभी ऐप्लिकेशन के लिए, डिसप्ले के आसपेक्ट रेशियो का इस्तेमाल डिफ़ॉल्ट आसपेक्ट रेशियो के तौर पर किया जाए या नहीं.

इस्तेमाल का उदाहरण या संदर्भ
फ़्लोट वैल्यू को कॉन्फ़िगर करने के बजाय, डिसप्ले के आसपेक्ट रेशियो का इस्तेमाल प्रोग्राम के हिसाब से करने के लिए कॉन्फ़िगरेशन.

कैमरा

इस सेक्शन में, कॉन्फ़िगरेशन की उन सभी सेटिंग के बारे में बताया गया है जिनका असर, onCameraOpened के कॉलबैक पर ऐप्लिकेशन पर पड़ता है. इन सेटिंग से डिसप्ले, गतिविधि, और कैमरे के कॉन्फ़िगरेशन पर असर पड़ सकता है.

नाम जगह की जानकारी टाइप डिफ़ॉल्ट
config_isWindowManagerCameraCompatTreatmentEnabled frameworks/base/core/res/res/values/config.xml Bool false
ब्यौरा
इस कुकी का इस्तेमाल, कैमरे के बफ़र और ऐप्लिकेशन विंडो के ओरिएंटेशन में अंतर की वजह से होने वाली समस्याओं को ठीक करने के लिए किया जाता है.
इसमें फ़ुलस्क्रीन में कैमरे से जुड़ी फ़िक्स्ड ओरिएंटेशन वाली गतिविधियों को फ़ोर्स रोटेशन करना और स्प्लिट स्क्रीन में टूलटिप दिखाना शामिल है.
हर ऐप्लिकेशन के लिए, रोटेशन की सुविधा को बंद किया जा सकता है: OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION.

इस्तेमाल का उदाहरण या संदर्भ
इस सुविधा की मदद से, कैमरे की घुमाई गई झलक को ठीक किया जा सकता है. इसके लिए, डिसप्ले को ज़बरदस्ती घुमाया जाता है, ताकि वह ऐप्लिकेशन के अनुरोध किए गए ओरिएंटेशन से मेल खाए.
config_isWindowManagerCameraCompatSplitScreenAspectRatioEnabled frameworks/base/core/res/res/values/config.xml Bool false
ब्यौरा
यह कुकी कॉन्फ़िगर करती है कि कैमरा इस्तेमाल करने की सुविधा चालू होने पर, कोई गतिविधि स्प्लिट-स्क्रीन के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) का इस्तेमाल करती है या नहीं. साथ ही, यह भी कॉन्फ़िगर करती है कि गतिविधि फ़ुलस्क्रीन में कैमरे से कनेक्ट है या नहीं.

इस्तेमाल का उदाहरण या संदर्भ
यह कुकी, कैमरे की स्ट्रेच की गई झलक को ठीक करती है. इसके लिए, यह गतिविधि को कैंडीबार जैसे आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) में लेटरबॉक्स करती है.
आम तौर पर, इसका इस्तेमाल लैंडस्केप डिवाइसों पर फ़ोर्स रोटेट ट्रीटमेंट (config_isWindowManagerCameraCompatTreatmentEnabled और camera.enable_landscape_to_portrait) के साथ किया जाता है. इससे कैमरे के साथ काम करने से जुड़ी उन समस्याओं को ठीक किया जा सकता है जिनमें कैमरे का व्यू स्ट्रेच हो जाता है. इसके लिए, यह गतिविधि के लिए पोर्ट्रेट कैंडीबार जैसा आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) सिम्युलेट करता है.
camera.enable_landscape_to_portrait सिस्टम प्रॉपर्टी Bool false
ब्यौरा
इससे ट्रीटमेंट OVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT को गेट किया जाता है.
इस विकल्प को चुनने पर, लैंडस्केप मोड में कैमरे के आउटपुट को काटा जाता है और 90 डिग्री घुमाया जाता है, ताकि पोर्ट्रेट मोड में कैमरे के आउटपुट को सिम्युलेट किया जा सके. डिवाइस पर मौजूद सभी लैंडस्केप कैमरों के लिए, कैमरा सेंसर का ओरिएंटेशन पोर्ट्रेट मोड में रिपोर्ट किया गया है. कई ऐप्लिकेशन इस स्थिति को हैंडल नहीं करते और इमेज को स्ट्रेच करके दिखाते हैं.

इस्तेमाल का उदाहरण या कॉन्टेक्स्ट
इससे कैमरा HAL को घुमाने और क्रॉप करने की सुविधा चालू होती है. इमेज में बदलाव करने के बारे में ज़्यादा जानकारी के लिए, घुमाएं, काटें, और स्केल करें लेख पढ़ें.
बिल्ड के समय, अपनी mk फ़ाइल में यह कोड जोड़ें: PRODUCT_PROPERTY_OVERRIDES += camera.enable_landscape_to_portrait=true
इसके लिए, डिवाइस में HAL में SCALER_ROTATE_AND_CROP की सुविधा होनी चाहिए. CameraCharacteristics#SCALER_AVAILABLE_ROTATE_AND_CROP_MODES देखें.
SCALER_ROTATE_AND_CROP के लिए, एचएएल के हिसाब से लागू करने के बारे में दिशा-निर्देश पाने के लिए, metadata_definitions.xml देखें.

बैकग्राउंड और यूज़र इंटरफ़ेस (यूआई)

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

नाम जगह की जानकारी टाइप डिफ़ॉल्ट
config_letterboxActivityCornersRadius frameworks/base/core/res/res/values/config.xml Integer 0
ब्यौरा
यह लेटरबॉक्स मोड में दिखाई गई गतिविधि के लिए, कॉर्नर रेडियस कॉन्फ़िगर करता है. 0 से कम वैल्यू होने पर, कोनों को गोल किया जाता है. इसके लिए, डिवाइस के निचले कोने के रेडियस में से सबसे कम रेडियस का इस्तेमाल किया जाता है. 0 की डिफ़ॉल्ट वैल्यू, AppCompatLetterboxPolicy में गोल कोनों के लॉजिक को बंद कर देती है.

इस्तेमाल का उदाहरण या कॉन्टेक्स्ट
आम तौर पर, इसे फ़िज़िकल डिवाइस के गोल कोनों से मैच करने के लिए कॉन्फ़िगर किया जाता है.
config_letterboxIsEnabledForTranslucentActivities frameworks/base/core/res/res/values/config.xml Bool false
ब्यौरा
इससे यह कॉन्फ़िगर किया जाता है कि पारदर्शी गतिविधियों के लिए, लेटरबॉक्सिंग की सुविधा चालू है या नहीं.

इस्तेमाल का उदाहरण या संदर्भ
इससे पारदर्शी गतिविधियों या मोडल को लेटरबॉक्स किया जा सकता है. साथ ही, इन्हें लेटरबॉक्स की गई गतिविधि के कॉन्फ़िगरेशन के हिसाब से सीमित किया जा सकता है. यह नीति TransparentPolicy में लागू होती है.
config_isCompatFakeFocusEnabled frameworks/base/core/res/res/values/config.xml Bool false
ब्यौरा
इससे यह कॉन्फ़िगर किया जाता है कि स्प्लिट स्क्रीन में फिर से शुरू की गई गतिविधियों के लिए, फ़ोकस की स्थिति को गलत तरीके से दिखाने की सुविधा चालू है या नहीं.
यह ज़रूरी है, क्योंकि कुछ गेम इंजन, ऐप्लिकेशन के कॉन्टेंट को ड्रॉ करने से पहले फ़ोकस पाने का इंतज़ार करते हैं. यह सुविधा, मल्टी-विंडो मोड में डिफ़ॉल्ट रूप से उपलब्ध नहीं होती.

इस्तेमाल का उदाहरण या कॉन्टेक्स्ट
यह एक लेगसी फ़्लैग है. इसका इस्तेमाल, Unity गेम इंजन के साथ काम करने वाले ऐप्लिकेशन के लिए किया जाता है. ये ऐसे ऐप्लिकेशन होते हैं जो स्प्लिट-स्क्रीन मोड में जाने के बाद काले हो जाते हैं. साथ ही, इन्हें सिर्फ़ तब ड्रॉ किया जाता है, जब उपयोगकर्ता ऐप्लिकेशन पर टैप करता है और उसे फ़ोकस करता है.
config_letterboxBackgroundType frameworks/base/core/res/res/values/config.xml Integer 0
ब्यौरा
यह विकल्प, लेटरबॉक्स के बैकग्राउंड के कॉर्नर की स्टाइल कॉन्फ़िगर करता है:
  • 0 - R.color.config_letterboxBackgroundColor में बताए गए रंग का इस्तेमाल करके, सॉलिड बैकग्राउंड.
  • 1 - लेटरबॉक्स वाले ऐप्लिकेशन के लिए, R.attr.colorBackground में बताया गया रंग.
  • 2 - लेटरबॉक्स वाले ऐप्लिकेशन के लिए, R.attr.colorBackgroundFloating में बताया गया रंग.
  • 3 - धुंधलेपन या गहरे रंग के स्क्रिम वाला वॉलपेपर. इनमें से कम से कम एक पैरामीटर की वैल्यू 0 से ज़्यादा होनी चाहिए: config_letterboxBackgroundWallpaperBlurRadius या config_letterboxBackgroundWallpaperDarkScrimAlpha. अगर ऐसा नहीं होता है या ब्लर करने का दायरा दिया गया है, लेकिन डिवाइस पर ब्लर करने की सुविधा काम नहीं करती है और इस विकल्प को चुना गया है, तो डिफ़ॉल्ट रूप से विकल्प 0 लागू हो जाएगा. अगर दी गई वैल्यू इस सीमा से बाहर है, तो विकल्प 0 को चुना जाएगा.


इस्तेमाल का उदाहरण या संदर्भ
परफ़ॉर्मेंस से जुड़ी मौजूदा समस्याओं की वजह से, इस सुविधा को लॉन्च नहीं किया गया है. ओईएम, इस सुविधा को लागू करने का अपना तरीका बना सकते हैं. हालांकि, एओएसपी किसी भी गड़बड़ी को ठीक नहीं करेगा.
config_letterboxBackgroundColor frameworks/base/core/res/res/values/config.xml Color @color/system_neutral1_1000
जानकारी
अगर इनमें से कोई एक शर्त पूरी होती है, तो यह विकल्प लेटरबॉक्स के बैकग्राउंड का रंग कॉन्फ़िगर करता है true:
  • R.integer.config_letterboxBackgroundType के लिए, 0 विकल्प चुना गया है.
  • R.integer.config_letterboxBackgroundType के लिए 1 विकल्प चुना गया है और ऐप्लिकेशन के लिए R.attr.colorBackground तय नहीं किया गया है.
  • R.integer.config_letterboxBackgroundType के लिए 2 विकल्प चुना गया है और ऐप्लिकेशन के लिए R.attr.colorBackgroundFloating तय नहीं किया गया है.
  • R.integer.config_letterboxBackgroundType के लिए 3 विकल्प चुना गया है और धुंधला करने का अनुरोध किया गया है, लेकिन यह सुविधा डिवाइस पर काम नहीं करती. इसके अलावा, डार्क स्क्रिम अल्फ़ा और ब्लर रेडियस, दोनों उपलब्ध नहीं हैं.


इस्तेमाल का उदाहरण या संदर्भ
परफ़ॉर्मेंस से जुड़ी मौजूदा समस्याओं की वजह से, इस सुविधा को लॉन्च नहीं किया गया है. ओईएम, इस सुविधा को लागू करने का अपना तरीका बना सकते हैं. हालांकि, एओएसपी किसी भी गड़बड़ी को ठीक नहीं करेगा.
config_letterboxBackgroundWallpaperBlurRadius frameworks/base/core/res/res/values/config.xml Dimen 38dp
ब्यौरा
इस विकल्प से, R.integer.config_letterboxBackgroundType में मौजूद विकल्प 3 के लिए ब्लर रेडियस कॉन्फ़िगर किया जाता है. 0 से कम वैल्यू को अनदेखा किया जाता है और 0 का इस्तेमाल किया जाता है.

इस्तेमाल का उदाहरण या संदर्भ
परफ़ॉर्मेंस से जुड़ी मौजूदा समस्याओं की वजह से, इस सुविधा को लॉन्च नहीं किया गया है. ओईएम, इस सुविधा को लागू करने का अपना तरीका बना सकते हैं. हालांकि, एओएसपी किसी भी गड़बड़ी को ठीक नहीं करेगा.
config_letterboxBackgroundWallpaperDarkScrimAlpha frameworks/base/core/res/res/values/config.xml Float 0.54
ब्यौरा
यह R.integer.config_letterboxBackgroundType के लिए विकल्प 3 चुने जाने पर, वॉलपेपर के लेटरबॉक्स बैकग्राउंड पर दिखने वाले काले रंग के पारदर्शी स्क्रिम के ऐल्फ़ा को कॉन्फ़िगर करता है. 0 से कम या 1 से ज़्यादा या उसके बराबर वैल्यू को अनदेखा कर दिया जाता है. इसके बजाय, 0.0 (पारदर्शी) का इस्तेमाल किया जाता है .

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

पहुंच और पोज़िशनिंग

इस सेक्शन में, ऐक्सेसिबिलिटी के लिए ऐक्टिविटी-लेवल की विंडो के कॉन्फ़िगरेशन पर लागू होने वाली सभी कॉन्फ़िगरेशन सेटिंग दी गई हैं.

नाम जगह की जानकारी टाइप डिफ़ॉल्ट
config_letterboxIsHorizontalReachabilityEnabled frameworks/base/core/res/res/values/config.xml Bool false
ब्यौरा
इससे यह कॉन्फ़िगर किया जाता है कि फ़ुल-स्क्रीन विंडो मोड में लेटरबॉक्स किए गए ऐप्लिकेशन के लिए, हॉरिज़ॉन्टल रीचेबिलिटी रीपोज़िशनिंग की सुविधा चालू है या नहीं.

इस्तेमाल का उदाहरण या संदर्भ
इससे पोर्ट्रेट ऐप्लिकेशन को आसानी से ऐक्सेस करने के लिए, बाईं या दाईं ओर ले जाया जाता है.
config_letterboxHorizontalPositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.5
ब्यौरा
यह लेटरबॉक्स वाली ऐप्लिकेशन विंडो के बीच की हॉरिज़ॉन्टल पोज़िशन को कॉन्फ़िगर करता है.
0 का मतलब स्क्रीन की बाईं ओर से है और 1 का मतलब दाईं ओर से है.
अगर दी गई वैल्यू 0 से कम या 1 से ज़्यादा है, तो इसे अनदेखा कर दिया जाता है. किताब के अलावा किसी अन्य चीज़ के लिए, बीच की पोज़िशन (0.5) का इस्तेमाल किया जाता है. किताब की पोज़िशन के लिए, बाईं ओर की पोज़िशन (0.0) का इस्तेमाल किया जाता है.

इस्तेमाल का उदाहरण या कॉन्टेक्स्ट
पोर्ट्रेट लेटरबॉक्स वाले ऐप्लिकेशन के लिए, यह डिफ़ॉल्ट रूप से बीच में होता है.
config_letterboxIsVerticalReachabilityEnabled frameworks/base/core/res/res/values/config.xml Bool false
ब्यौरा
इससे यह कॉन्फ़िगर किया जाता है कि फ़ुल-स्क्रीन विंडो मोड में लेटरबॉक्स वाले ऐप्लिकेशन के लिए, वर्टिकल रीचेबिलिटी रीपोज़िशनिंग की सुविधा चालू है या नहीं.

इस्तेमाल का उदाहरण या कॉन्टेक्स्ट
इससे लैंडस्केप ऐप्लिकेशन को आसानी से ऐक्सेस करने के लिए, ऊपर या नीचे की ओर ले जाया जाता है.
config_letterboxVerticalPositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
ब्यौरा
यह लेटरबॉक्स किए गए ऐप्लिकेशन की विंडो के बीच की वर्टिकल पोज़िशन को कॉन्फ़िगर करता है.
वैल्यू 0 का मतलब स्क्रीन का ऊपरी हिस्सा है और 1 का मतलब निचला हिस्सा है.
अगर दी गई वैल्यू 0 से कम या 1 से ज़्यादा है, तो इसे अनदेखा कर दिया जाता है. टेबलटॉप मोड के अलावा, अन्य मोड के लिए सेंटर की पोज़िशन (0.5) का इस्तेमाल किया जाता है. टेबल पर रखकर इस्तेमाल करने के लिए, सबसे ऊपर वाली पोज़िशन (0.0) का इस्तेमाल किया जाता है.

इस्तेमाल का उदाहरण या कॉन्टेक्स्ट
लैंडस्केप मोड में लेटरबॉक्स किए गए ऐप्लिकेशन के लिए, बड़ी स्क्रीन वाले डिवाइसों में बीच में कॉन्फ़िगर किया गया है.
config_letterboxIsAutomaticReachabilityInBookModeEnabled frameworks/base/core/res/res/values/config.xml Bool false
ब्यौरा
इस सेटिंग से यह कॉन्फ़िगर किया जाता है कि फ़ुल-स्क्रीन विंडो मोड में लेटरबॉक्स वाले ऐप्लिकेशन के लिए, बुक पॉस्चर में अपने-आप हॉरिज़ॉन्टल पहुंच की सुविधा चालू है या नहीं.

इस्तेमाल का उदाहरण या संदर्भ
इस सेटिंग की मदद से, पोर्ट्रेट मोड में लेटरबॉक्स वाले ऐप्लिकेशन को फ़ोल्ड किए जा सकने वाले डिवाइस के बुक पॉस्चर में होने पर, बाईं और दाईं ओर ले जाया जा सकता है.
config_letterboxBookModePositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
ब्यौरा
इस सेटिंग का इस्तेमाल, बुक मोड में लेटरबॉक्स वाली ऐप्लिकेशन विंडो के बीच की हॉरिज़ॉन्टल पोज़िशन को कॉन्फ़िगर करने के लिए किया जाता है.
0 का मतलब स्क्रीन की बाईं ओर से है और 1 का मतलब दाईं ओर से है. अगर दी गई वैल्यू 0 से कम या 1 से ज़्यादा है, तो इसे अनदेखा कर दिया जाता है. इसके बजाय, बाईं ओर की पोज़िशन (0.0) का इस्तेमाल किया जाता है.

इस्तेमाल का उदाहरण या संदर्भ
यह मल्टीप्लायर, ऐप्लिकेशन की पोज़िशन को तय करता है. यह बताता है कि किताब की तरह फ़ोन को पकड़ने पर, ऐप्लिकेशन की पोज़िशन कितनी बदलेगी.
config_letterboxDefaultPositionForBookModeReachability frameworks/base/core/res/res/values/config.xml Integer 0
ब्यौरा
इस सेटिंग की मदद से, लेटरबॉक्स किए गए ऐप्लिकेशन की विंडो की डिफ़ॉल्ट हॉरिज़ॉन्टल पोज़िशन कॉन्फ़िगर की जाती है. ऐसा तब होता है, जब पहुंच की सुविधा चालू हो और ऐप्लिकेशन, लैंडस्केप डिवाइस ओरिएंटेशन और बुक मोड में फ़ुलस्क्रीन पर हो. रीचेबिलिटी की सुविधा चालू होने पर, इसकी पोज़िशन बाएं, बीच में, और दाईं ओर बदल सकती है:
  • विकल्प 0 - लेफ़्ट
  • विकल्प 1 - बीच में
  • विकल्प 2 - राइट
अगर दी गई वैल्यू इस रेंज से बाहर है, तो विकल्प 0 (बाएं) को चुना जाएगा.

इस्तेमाल का उदाहरण या संदर्भ
बुक मोड में ऐप्लिकेशन को डिफ़ॉल्ट रूप से इस जगह पर रखा जाता है.
config_letterboxTabletopModePositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
ब्यौरा
टेबलटॉप मोड में, लेटरबॉक्स वाली ऐप्लिकेशन विंडो के बीच की वर्टिकल पोज़िशन कॉन्फ़िगर करता है.
वैल्यू 0 का मतलब स्क्रीन का ऊपरी हिस्सा है और 1 का मतलब निचला हिस्सा है. अगर दी गई वैल्यू 0 से कम या 1 से ज़्यादा है, तो इसे अनदेखा कर दिया जाता है. साथ ही, टॉप पोज़िशन 0.0 का इस्तेमाल किया जाता है.

इस्तेमाल का उदाहरण या संदर्भ
यह मल्टीप्लायर, फ़ोल्ड किए जा सकने वाले डिवाइस में टेबलटॉप मोड में ऐप्लिकेशन की पोज़िशन को बदलने के लिए इस्तेमाल किया जाता है.
config_letterboxDefaultPositionForTabletopModeReachability frameworks/base/core/res/res/values/config.xml Integer 0
जानकारी
इस विकल्प की मदद से, लेटरबॉक्स किए गए ऐप्लिकेशन की विंडो की डिफ़ॉल्ट वर्टिकल पोज़िशन कॉन्फ़िगर की जाती है. ऐसा तब होता है, जब पहुंच की सुविधा चालू हो और कोई ऐप्लिकेशन, पोर्ट्रेट डिवाइस ओरिएंटेशन और टेबलटॉप मोड में फ़ुलस्क्रीन पर हो. रीचेबिलिटी की सुविधा चालू होने पर, विज्ञापन की जगह टॉप, सेंटर, और बॉटम के बीच बदल सकती है. इस कॉन्फ़िगरेशन में, डिफ़ॉल्ट कॉन्फ़िगरेशन के बारे में बताया गया है:
  • विकल्प 0 - सबसे ऊपर
  • विकल्प 1 - बीच में
  • विकल्प 2 - सबसे नीचे
अगर दी गई वैल्यू इस रेंज से बाहर है, तो विकल्प 0 (सबसे ऊपर) को चुना जाएगा.

इस्तेमाल का उदाहरण या संदर्भ
यह डिफ़ॉल्ट पोज़िशन है, जहां ऐप्लिकेशन को टेबलटॉप मोड में रखा जाता है.

सेटिंग

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

नाम जगह की जानकारी टाइप डिफ़ॉल्ट
config_appCompatUserAppAspectRatioSettingsIsEnabled frameworks/base/core/res/res/values/config.xml Bool false
ब्यौरा
इस सेटिंग से यह तय होता है कि हर ऐप्लिकेशन के लिए, उपयोगकर्ता के चुने गए आसपेक्ट रेशियो को बदलने की सेटिंग चालू है या नहीं.

इस्तेमाल का उदाहरण या संदर्भ
इस सेटिंग से, सेटिंग > ऐप्लिकेशन > आस्पेक्ट रेशियो में जाकर, आस्पेक्ट रेशियो की सेटिंग को चालू किया जा सकता है.
config_appCompatUserAppAspectRatioFullscreenIsEnabled frameworks/base/core/res/res/values/config.xml Bool false
ब्यौरा
इससे यह कॉन्फ़िगर किया जाता है कि उपयोगकर्ता के लिए, ऐप्लिकेशन के हिसाब से फ़ुलस्क्रीन मोड को बंद करने का विकल्प चालू है या नहीं. यह विकल्प, आस्पेक्ट रेशियो की सेटिंग में मौजूद होता है.

इस्तेमाल का उदाहरण या संदर्भ
इससे उपयोगकर्ता के लिए, आस्पेक्ट रेशियो की सेटिंग में फ़ुल स्क्रीन विकल्प चालू हो जाता है.
इस सेटिंग से, ऐप्लिकेशन के साइज़ में बदलाव न किए जा सकने, आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात), और ओरिएंटेशन से जुड़ी पाबंदियों को अनदेखा किया जाता है.
config_userAspectRatioOverrideEntries packages/apps/Settings/res/values/config.xml string-array सभी विकल्प डिफ़ॉल्ट रूप से चालू होते हैं.
ब्यौरा
यह नीति, ऐप्लिकेशन के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) की सेटिंग वाली स्क्रीन और उपयोगकर्ता के आसपेक्ट रेशियो को बदलने के विकल्पों को कॉन्फ़िगर करती है. इनकी लंबाई और क्रम, config_userAspectRatioOverrideValues के बराबर होना चाहिए.
अगर बदलाव किया गया है, तो UserAspectRatioBackupManager.java में सबसे मिलती-जुलती वैल्यू चुनने के लिए, बैकअप और रीस्टोर करने के लॉजिक को भी अपडेट करें.

इस्तेमाल का उदाहरण या संदर्भ
सेटिंग में दिखने वाली स्ट्रिंग के लिए मैपिंग.
config_userAspectRatioOverrideValues packages/apps/Settings/res/values/config.xml integer-array सभी एओएसपी स्ट्रिंग का इस्तेमाल डिफ़ॉल्ट रूप से किया जाता है.
ब्यौरा
यह नीति, ऐप्लिकेशन के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) की सेटिंग वाली स्क्रीन और उपयोगकर्ता के आसपेक्ट रेशियो को बदलने के विकल्पों को कॉन्फ़िगर करती है. इनकी लंबाई और क्रम, config_userAspectRatioOverrideEntries के बराबर होना चाहिए. ये वैल्यू, PackageManager.UserMinAspectRatio से मेल खानी चाहिए.
अगर बदलाव किया गया है, तो UserAspectRatioBackupManager.java में सबसे मिलती-जुलती वैल्यू चुनने के लिए, बैकअप और वापस लाने की सुविधा से जुड़े लॉजिक को भी अपडेट करें.

इस्तेमाल का उदाहरण या कॉन्टेक्स्ट
बैकएंड PackageManager.UserMinAspectRatio के विकल्पों के लिए मैपिंग:
  • ऐप्लिकेशन की डिफ़ॉल्ट भाषा - 0
  • स्प्लिट स्क्रीन - 1
  • डिसप्ले आसपेक्ट रेशियो - 2
  • 4:3 - 3
  • 16:9 - 4
  • 3:2 - 5
  • फ़ुल स्क्रीन - 6
हल्के रंग वाली थीम के स्टैटिक ड्रॉअबल packages/apps/Settings/res/drawable/ic_app_aspect_ratio_<option>.xml vector फ़ोल्ड किए जा सकने वाले डिवाइस के लैंडस्केप मोड के साइज़ की ऐसेट
ब्यौरा
यह उपलब्ध ड्रॉएबल को कॉन्फ़िगर करता है:


इस्तेमाल का उदाहरण या कॉन्टेक्स्ट
सेटिंग > ऐप्लिकेशन की जानकारी > आस्पेक्ट रेशियो में हर विकल्प के नीचे, हल्के रंग वाली स्टैटिक इमेज.
गहरे रंग वाली थीम के स्टैटिक ड्रॉएबल packages/apps/Settings/res/drawable-night/ic_app_aspect_ratio_<option>.xml vector फ़ोल्ड किए जा सकने वाले डिवाइस के लैंडस्केप मोड के साइज़ की ऐसेट
ब्यौरा
यह उपलब्ध ड्रॉएबल को कॉन्फ़िगर करता है:


इस्तेमाल का उदाहरण या कॉन्टेक्स्ट
सेटिंग > ऐप्लिकेशन की जानकारी > आस्पेक्ट रेशियो में हर विकल्प के नीचे, डार्क थीम वाली स्टैटिक इमेज.
डाइनैमिक ड्रॉएबल
user_aspect_ratio_education.json		 packages/apps/Settings/res/raw/user_aspect_ratio_education.json JSON फ़ोल्ड किए जा सकने वाले डिवाइस के लैंडस्केप मोड के लिए डाइनैमिक ऐसेट
ब्यौरा
यह UserAspectRatioAppsPageProvider में Lottie इलस्ट्रेशन को कॉन्फ़िगर करता है.

इस्तेमाल का उदाहरण या संदर्भ
ऐप्लिकेशन की सूची में मौजूद ऐनिमेशन: सेटिंग > ऐप्लिकेशन > आस्पेक्ट रेश्यो.

शिक्षा

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

नाम जगह की जानकारी टाइप डिफ़ॉल्ट
config_letterboxIsEducationEnabled frameworks/base/core/res/res/values/config.xml Bool false
ब्यौरा
यह कॉन्फ़िगर करता है कि फ़ुलस्क्रीन पर दिखने वाले ऐप्लिकेशन के लिए, लेटरबॉक्स एजुकेशन की सुविधा चालू है या नहीं.

इस्तेमाल का उदाहरण या संदर्भ
फ़ुलस्क्रीन पर दिखने वाले ऐप्लिकेशन के लिए, लेटरबॉक्स एजुकेशन की सुविधा के इस्तेमाल का उदाहरण देखने के लिए, पहली इमेज देखें.
config_letterboxIsRestartDialogEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool false
ब्यौरा
इससे यह कॉन्फ़िगर किया जाता है कि एक्सटेंडेड रीस्टार्ट डायलॉग चालू है या नहीं.

इस्तेमाल का उदाहरण या संदर्भ
एक्सटेंडेड रीस्टार्ट डायलॉग के इस्तेमाल का उदाहरण देखने के लिए, दूसरी इमेज देखें.
config_letterboxIsReachabilityEducationEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool false
ब्यौरा
यह कॉन्फ़िगर करता है कि पहुंच से जुड़ी अतिरिक्त जानकारी देने की सुविधा चालू है या नहीं.

इस्तेमाल का उदाहरण या संदर्भ
पहुंच से जुड़ी जानकारी देने की सुविधा के इस्तेमाल का उदाहरण देखने के लिए, तीसरी इमेज देखें.
config_isSizeCompatRestartButtonEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool true
ब्यौरा
इससे यह कॉन्फ़िगर किया जाता है कि साइज़ के हिसाब से काम करने वाले ऐप्लिकेशन के लिए, रीस्टार्ट बटन चालू है या नहीं.

इस्तेमाल का उदाहरण या कॉन्टेक्स्ट
रीस्टार्ट बटन का इस्तेमाल, विंडो का साइज़ बदलने के बाद, साइज़ बदलने की सुविधा के बिना काम करने वाले ऐप्लिकेशन के कॉन्फ़िगरेशन को रीस्टार्ट करने के लिए किया जाता है. उदाहरण के लिए, स्प्लिट-स्क्रीन मोड में जाने या डिसप्ले को घुमाने पर.
साइज़ के हिसाब से कंपैटिबिलिटी की जांच करने के बाद रीस्टार्ट करने वाले बटन के इस्तेमाल का उदाहरण देखने के लिए, चौथी इमेज देखें.
config_letterboxRestartButtonHideTolerance frameworks/base/libs/WindowManager/Shell/res/values/config.xml Integer 100
Description
इस सेटिंग की मदद से, टास्क में गतिविधि की सीमाओं के प्रतिशत की कम से कम टॉलरेंस को कॉन्फ़िगर किया जाता है. इससे साइज़ के हिसाब से रीस्टार्ट करने का बटन छिपाया जा सकता है. 0 से कम या 100 से ज़्यादा वैल्यू को अनदेखा कर दिया जाता है.
100 डिफ़ॉल्ट वैल्यू है. इसमें गतिविधि को टास्क के हिसाब से सटीक होना चाहिए, ताकि साइज़ के हिसाब से रीस्टार्ट करने वाले बटन को छिपाया जा सके. 0 वैल्यू का मतलब है कि रीस्टार्ट करने का बटन हमेशा छिपा रहता है.

इस्तेमाल का उदाहरण या संदर्भ
इसका इस्तेमाल, स्क्वेयर जैसे डिवाइसों में किया जाता है. इससे रीस्टार्ट करने का बटन तब छिपाया जाता है, जब उपयोगकर्ता ऐसे ऐप्लिकेशन को रोटेट करता है जिनका साइज़ नहीं बदला जा सकता. हालांकि, ऐप्लिकेशन को रीस्टार्ट करने से यूज़र इंटरफ़ेस (यूआई) में ज़्यादा सुधार नहीं होगा.

इन इमेज में, शिक्षा से जुड़ी जानकारी दिखाने वाली लेयर के इस्तेमाल के उदाहरण दिए गए हैं:

फ़ुलस्क्रीन ऐप्लिकेशन के लिए लेटरबॉक्स मोड

पहली इमेज. फ़ुलस्क्रीन ऐप्लिकेशन के लिए लेटरबॉक्स मोड

रीस्टार्ट करने के लिए ज़्यादा समय देने वाले डायलॉग का उदाहरण.

दूसरी इमेज. रीस्टार्ट करने का बड़ा किया गया डायलॉग बॉक्स

पहुंचने की क्षमता के बारे में जानकारी देने वाले वीडियो का उदाहरण.

तीसरी इमेज. रीचेबिलिटी के बारे में शिक्षा.

साइज़ के हिसाब से काम करने की सुविधा को फिर से शुरू करने वाले बटन का उदाहरण.

चौथी इमेज. आकार के हिसाब से कंपैटिबिलिटी मोड को रीस्टार्ट करने का बटन.