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

تقدّم الصفحة دليل إعداد وفهرسًا شاملَين لتراكبات إعدادات توافق التطبيقات مع أجهزة 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.
config_isCameraCompatSimulateRequestedOrientationTreatmentEnabled frameworks/base/core/res/res/values/config.xml Bool true
الوصف
يشير إلى ما إذا كان قد تم تفعيل معالجة التوافق مع الكاميرا، والتي تحاكي اتجاه الشاشة المطلوب للتطبيق. الغرض من المعالجة هو الحدّ من المشاكل الناتجة عن عدم تطابق اتجاه العرض بين مخزن بيانات الكاميرا ونافذة التطبيق. ويشمل ذلك وضع إطار أسود حول الأنشطة ذات الاتجاه الثابت المرتبطة بالكاميرا، واقتصاص مخزن الكاميرا المؤقت (تدوير واقتصاص)، وعزل تدوير الشاشة في وضع الحماية ليتوافق مع الاتجاه المتوقع للتطبيق.

حالة الاستخدام أو السياق
محاكاة الاتجاه المطلوب لأنشطة الكاميرا في:
  • وضع عرض المحتوى في نافذة حرة
  • طلب اتجاه ثابت، بخلاف الوضعَين locked أو nosensor

في نظام التشغيل Android 17 والإصدارات الأحدث، يؤدي هذا الإعداد إلى إيقاف معالجة التدوير الإجباري من config_isWindowManagerCameraCompatTreatmentEnabled وتوحيد السياسات الخاصة بوضع الحماية لتدوير الشاشة، وتضمين الصورة في إطار، وتدوير الكاميرا واقتصاص الصورة لتطبيقات الكاميرا ذات الاتجاه الثابت.
config_isCameraCompatSimReqOrientationLandscapeTreatmentEnabled frameworks/base/core/res/res/values/config.xml Bool false
الوصف
يشير إلى ما إذا كان قد تم تفعيل معالجة توافق الكاميرا التي تحاكي اتجاه التطبيق المطلوب للكاميرات الأفقية. الغرض من هذه المعالجة هو الحدّ من المشاكل الناتجة عن الترميز الثابت لمستشعرات الكاميرا في الوضع العمودي في التطبيقات. يشمل هذا الإجراء عرض الأنشطة ذات الاتجاه الثابت المرتبطة بالكاميرا في مربّع مع ترك مساحة فارغة على الجانبين، واقتصاص مخزن الكاميرا المؤقت (تدوير واقتصاص)، وتحديد اتجاه جهاز الاستشعار على الوضع العمودي، وعزل تدوير الشاشة ليتطابق مع الاتجاه المتوقّع للتطبيق.

حالة الاستخدام أو السياق
في نظام التشغيل Android 17 والإصدارات الأحدث، يكون هذا الإجراء مشابهًا لإجراء محاكاة الاتجاه المطلوب config_isCameraCompatSimulateRequestedOrientationTreatmentEnabled ولكن للأجهزة التي تحتوي على كاميرات باتجاه أفقي.

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

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

الاسم الموقع الجغرافي النوع تلقائي
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
الوصف
يضبط هذا الخيار لون خلفية Letterbox في إحدى الحالات التالية: 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_enableSelfKillRecoveryBetweenInternalDisplays frameworks/base/core/res/res/values/config.xml Bool false
الوصف
عندما تكون قيمة true، لا يتم استثناء عمليات نقل العرض بين الشاشات الداخلية من منطق استرداد البيانات بعد الإغلاق الذاتي.

حالة الاستخدام أو السياق
في نظام التشغيل Android 17 والإصدارات الأحدث، لا يتم تفعيل عملية استرداد البيانات بعد الإغلاق الذاتي إلا لعمليات نقل العرض التي تتضمّن شاشات خارجية. ومع ذلك، تكون هذه العملية فعّالة أيضًا على الهواتف القابلة للطي التي تتضمّن كثافات مختلفة على شاشتيها الداخلية والخارجية. يتيح هذا الإعداد هذه العملية على تلك الأجهزة.

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

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

الاسم الموقع الجغرافي النوع تلقائي
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
الوصف
يضبط هذا الإعداد ما إذا كان سيتم تفعيل ميزة "التعليم في وضع ملء الشاشة مع عرض شريطين أسودين" للتطبيقات التي تعمل في وضع ملء الشاشة مع عرض شريطين أسودين.

حالة الاستخدام أو السياق
راجِع الشكل 1 للاطّلاع على حالة استخدام ميزة "التعليم في وضع ملء الشاشة مع عرض شريطين أسودين" للتطبيقات التي تعمل في وضع ملء الشاشة.
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. زر إعادة تشغيل التوافق مع الحجم