دليل إعداد توافق التطبيقات مع الشاشات الكبيرة

تقدّم الصفحة دليل إعداد وفهرسًا شاملَين لتراكبات إعدادات توافق التطبيقات مع شاشات Android الكبيرة.

الشاشة

يسرد هذا القسم جميع إعدادات الضبط التي تؤثر في الضبط على مستوى العرض.

الاسم الموقع الجغرافي النوع تلقائي
ignoreOrientationRequest display_settings.xml config false
true للشاشات الكبيرة (600 وحدة بكسل مستقلة عن الكثافة أو أكثر)
الوصف
تتيح هذه السمة للمستخدمين تدوير الأنشطة ذات الاتجاه الثابت على الشاشة المحدّدة مجانًا.
مثال: 
          <display-settings>
              <config identifier="0" />
              <display
                  name="<display's uniqueId>"
                  ignoreOrientationRequest="true"/>
          </display-settings>

حالة الاستخدام أو السياق
يتجاهل العرض الاتجاه المطلوب لجميع التطبيقات، ويتم تضمين التطبيق في مربّع.
يتم استخدامها على جميع الأجهزة ذات الشاشات الكبيرة ونظام التشغيل Android Automotive. هذا هو الإعداد التلقائي لجميع الأجهزة ذات الشاشات الكبيرة التي تعمل بالإصدار 16 من نظام التشغيل Android والإصدارات الأحدث.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
يتطلّب هذا الإجراء أن يتوافق الجهاز مع SCALER_ROTATE_AND_CROP في طبقة HAL. يمكنك الاطّلاع على CameraCharacteristics#SCALER_AVAILABLE_ROTATE_AND_CROP_MODES.
للحصول على إرشادات حول التنفيذ الخاص بطبقة تجريد الأجهزة (HAL) في SCALER_ROTATE_AND_CROP، يُرجى الاطّلاع على metadata_definitions.xml.

الخلفية وواجهة المستخدم

يسرد هذا القسم جميع إعدادات الضبط التي يتم تطبيقها على سطح طبقة &quot;المربّع الأسود&quot; لتخصيص واجهة المستخدم، أو على مستوى النشاط.

الاسم الموقع الجغرافي النوع تلقائي
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.


حالة الاستخدام أو السياق
لم يتم إطلاق هذه الميزة بسبب مشاكل الأداء الحالية. يمكن لمصنّعي المعدات الأصلية إنشاء تنفيذ خاص بهم لهذه الميزة، ولكن لن يتعامل مشروع Android المفتوح المصدر (AOSP) مع أي أخطاء.
config_letterboxBackgroundColor frameworks/base/core/res/res/values/config.xml Color @color/system_neutral1_1000
الوصف
يضبط هذا الخيار لون خلفية شريط الرسائل إذا تحقّقت إحدى الحالات التالية true:
  • تم تحديد الخيار 0 لـ R.integer.config_letterboxBackgroundType.
  • تم تحديد الخيار 1 لـ R.integer.config_letterboxBackgroundType ولم يتم تحديد R.attr.colorBackground للتطبيق.
  • تم تحديد الخيار 2 لـ R.integer.config_letterboxBackgroundType ولم يتم تحديد R.attr.colorBackgroundFloating للتطبيق.
  • تم تحديد الخيار 3 لـ R.integer.config_letterboxBackgroundType وتم طلب التمويه ولكنّه غير متاح على الجهاز، أو لم يتم توفير كل من قيمة ألفا الخاصة بالخلفية الداكنة ونصف قطر التمويه.


حالة الاستخدام أو السياق
لم يتم إطلاق هذه الميزة بسبب مشاكل الأداء الحالية. يمكن لمصنّعي المعدات الأصلية إنشاء تنفيذ خاص بهم لهذه الميزة، ولكن لن يتعامل مشروع Android المفتوح المصدر (AOSP) مع أي أخطاء.
config_letterboxBackgroundWallpaperBlurRadius frameworks/base/core/res/res/values/config.xml Dimen 38dp
الوصف
تضبط هذه السمة نصف قطر التمويه للخيار 3 في R.integer.config_letterboxBackgroundType. يتم تجاهل القيم الأقل من 0، ويتم استخدام 0.

حالة الاستخدام أو السياق
لم يتم إطلاق هذه الميزة بسبب مشاكل الأداء الحالية. يمكن لمصنّعي المعدات الأصلية إنشاء تنفيذ خاص بهم لهذه الميزة، ولكن لن يتعامل مشروع Android المفتوح المصدر (AOSP) مع أي أخطاء.
config_letterboxBackgroundWallpaperDarkScrimAlpha frameworks/base/core/res/res/values/config.xml Float 0.54
الوصف
يضبط هذا الخيار مستوى الشفافية في طبقة سوداء شفافة تظهر فوق خلفية شاشة العرض عند اختيار الخيار 3 في R.integer.config_letterboxBackgroundType. يتم تجاهل القيم الأقل من 0 أو الأكبر من أو تساوي 1، ويتم استخدام 0.0 (شفاف) بدلاً من ذلك.

حالة الاستخدام أو السياق
لم يتم إطلاق هذه الميزة بسبب مشاكل الأداء الحالية. يمكن لمصنّعي المعدات الأصلية إنشاء تنفيذ خاص بهم لهذه الميزة، ولكن لن يتعامل مشروع Android المفتوح المصدر (AOSP) مع أي أخطاء.

إمكانية الوصول وتحديد الموضع

يسرد هذا القسم جميع إعدادات الضبط المطبَّقة على إعدادات النافذة على مستوى النشاط لتسهيل الاستخدام.

الاسم الموقع الجغرافي النوع تلقائي
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
الوصف
يضبط هذا الإعداد الموضع الأفقي التلقائي لنافذة التطبيق التي يتم عرضها على شاشة عريضة أفقيًا عندما يكون وضع سهولة الاستخدام مفعّلاً ويكون التطبيق في وضع ملء الشاشة على جهاز في الوضع الأفقي وفي وضع الكتاب. عند تفعيل ميزة &quot;سهولة الوصول&quot;، يمكن تغيير الموضع بين اليسار والوسط واليمين:
  • الخيار 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 يتم استخدام جميع سلاسل AOSP تلقائيًا.
الوصف
تضبط هذه السياسة شاشة إعدادات نسبة العرض إلى الارتفاع للتطبيق وخيارات إلغاء نسبة العرض إلى الارتفاع التي يحدّدها المستخدم. يجب أن يكون طولها وترتيبها مماثلَين لطول وترتيب 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 مواد العرض بحجم الهاتف القابل للطي في الوضع الأفقي
الوصف
يضبط العناصر الرسومية المتاحة:


حالة الاستخدام أو السياق
صور ثابتة ذات مظهر داكن ضمن كل خيار في الإعدادات > معلومات التطبيق > نسبة العرض إلى الارتفاع
Dynamic drawable
user_aspect_ratio_education.json		 packages/apps/Settings/res/raw/user_aspect_ratio_education.json JSON مادة عرض ديناميكية بحجم الجهاز القابل للطي في الوضع الأفقي
الوصف
يضبط هذا الخيار رسمًا توضيحيًا بتنسيق Lottie في UserAspectRatioAppsPageProvider.

حالة الاستخدام أو السياق
صورة متحركة ضمن قائمة التطبيقات: الإعدادات > التطبيقات > نسبة العرض إلى الارتفاع.

التعليم

يسرد هذا القسم جميع إعدادات الضبط الخاصة بتعريف المستخدمين على ميزات توافق التطبيقات.

الاسم الموقع الجغرافي النوع تلقائي
config_letterboxIsEducationEnabled frameworks/base/core/res/res/values/config.xml Bool false
الوصف
يضبط هذا الإعداد ما إذا كان سيتم تفعيل ميزة &quot;التعليم في وضع ملء الشاشة مع عرض شريطين أسودين&quot; للتطبيقات التي تعمل في وضع ملء الشاشة مع عرض شريطين أسودين.

حالة الاستخدام أو السياق
راجِع الشكل 1 للاطّلاع على حالة استخدام ميزة &quot;التعليم في وضع ملء الشاشة مع عرض شريطين أسودين&quot; للتطبيقات التي تعمل في وضع ملء الشاشة.
config_letterboxIsRestartDialogEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool false
الوصف
يضبط هذا الخيار ما إذا كان سيتم تفعيل مربّع حوار إعادة التشغيل الموسّعة.

حالة الاستخدام أو السياق
راجِع الشكل 2 للاطّلاع على حالة استخدام مربّع حوار إعادة التشغيل الموسّعة.
config_letterboxIsReachabilityEducationEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool false
الوصف
تضبط هذه السمة ما إذا كان سيتم تفعيل معلومات إضافية حول إمكانية الوصول.

حالة الاستخدام أو السياق
اطّلِع على الشكل 3 لمعرفة حالة استخدام معلومات إمكانية الوصول.
config_isSizeCompatRestartButtonEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool true
الوصف
تضبط هذه السمة ما إذا كان زر إعادة التشغيل المتوافق مع الحجم مفعَّلاً.

حالة الاستخدام أو السياق
زر إعادة التشغيل لإعادة تشغيل الإعدادات للتطبيقات غير القابلة لتغيير الحجم بعد تغيير حجم النافذة، مثلاً عند الانتقال إلى وضع تقسيم الشاشة أو تدوير الشاشة.
راجِع الشكل 4 للاطّلاع على حالة استخدام لزر إعادة التشغيل المتوافق مع حجم الشاشة.
config_letterboxRestartButtonHideTolerance frameworks/base/libs/WindowManager/Shell/res/values/config.xml Integer 100
الوصف
تضبط هذه السمة الحد الأدنى من التفاوت في نسبة حدود النشاط ضمن مهمتها لإخفاء زر إعادة التشغيل المتوافق مع الحجم. يتم تجاهل القيم الأقل من 0 أو الأعلى من 100.
100 هي القيمة التلقائية التي يجب أن يتناسب النشاط معها تمامًا ضمن المهمة للسماح بإخفاء زر إعادة التشغيل الخاص بالتوافق مع الحجم. تعني القيمة 0 أنّه سيتم إخفاء زر إعادة التشغيل الخاص بالتوافق مع الحجم دائمًا.

حالة الاستخدام أو السياق
يتم استخدام هذه القيمة في الأجهزة القريبة من المربع لإخفاء زر إعادة التشغيل عندما يدير المستخدم التطبيقات غير القابلة لتغيير الحجم، ولكن لن تؤدي إعادة تشغيل التطبيق إلى تحسين واجهة المستخدم بشكل كبير.

تعرض الصور التالية حالات استخدام لطبقة العرض التعليمية:

التعليمات المتعلقة بوضع &quot;عرض بنسبة عرض إلى ارتفاع غير كاملة&quot; للتطبيقات في وضع ملء الشاشة

الشكل 1: التعليمات المتعلقة بوضع "عرض بنسبة عرض إلى ارتفاع غير كاملة" للتطبيقات في وضع ملء الشاشة

مثال على مربّع حوار إعادة التشغيل الموسّع

الشكل 2: مربّع حوار إعادة التشغيل الموسّع

مثال على التوعية بشأن إمكانية الوصول

الشكل 3: التعليم بشأن إمكانية الوصول

مثال على زر إعادة التشغيل الخاص بالتوافق مع الحجم

الشكل 4. زر إعادة تشغيل التوافق مع الحجم