راهنمای تنظیم سازگاری برنامه با صفحه نمایش بزرگ

این صفحه یک راهنمای جامع برای راه‌اندازی و فهرستی از تنظیمات سازگاری برنامه‌های اندروید با صفحه نمایش بزرگ ارائه می‌دهد.

نمایش

این بخش تمام تنظیمات پیکربندی که بر پیکربندی سطح نمایش تأثیر می‌گذارند را فهرست می‌کند.

نام مکان نوع پیش‌فرض
ignoreOrientationRequest display_settings.xml پیکربندی false
برای صفحه نمایش‌های بزرگ (>= 600dp) true
توضیحات
چرخش آزاد کاربر را در فعالیت‌های با جهت‌گیری ثابت روی صفحه نمایش مشخص‌شده فعال می‌کند.
مثال:
          <display-settings>
              <config identifier="0" />
              <display
                  name="<display's uniqueId>"
                  ignoreOrientationRequest="true"/>
          </display-settings>
        

مورد استفاده یا زمینه
نمایشگر، جهت‌گیری درخواستی همه برنامه‌ها را نادیده می‌گیرد و برنامه با حروف بزرگ نمایش داده می‌شود.
مورد استفاده در تمام دستگاه‌های صفحه بزرگ و سیستم عامل اندروید اتوموتیو. این مقدار پیش‌فرض برای تمام دستگاه‌های صفحه بزرگ با 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
توضیحات
پیکربندی می‌کند که آیا یک فعالیت هنگام فعال بودن قابلیت سازگاری با دوربین و اتصال آن به دوربین در حالت تمام‌صفحه، از نسبت تصویر تقسیم صفحه استفاده کند یا خیر.

مورد استفاده یا زمینه
پیش‌نمایش‌های دوربین کشیده‌شده را با قرار دادن فعالیت در یک نسبت ابعاد شبیه به آب‌نبات چوبی، با حروف بزرگ (letterboxing) برطرف می‌کند.
معمولاً در دستگاه‌های افقی، همراه با force rotation treatment enabled ( config_isWindowManagerCameraCompatTreatmentEnabled و camera.enable_landscape_to_portrait ) برای رفع مشکلات سازگاری دوربین کشیده شده با شبیه‌سازی نسبت ابعاد عمودی برای فعالیت، استفاده می‌شود.
camera.enable_landscape_to_portrait ویژگی سیستم Bool false
توضیحات
گیتس از گزینه OVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT استفاده می‌کند.
خروجی دوربین را مجبور می‌کند در دوربین‌هایی با جهت طبیعی افقی، برش داده شده و ۹۰ درجه بچرخد تا جهت طبیعی عمودی را شبیه‌سازی کند. جهت حسگر دوربین گزارش شده برای همه دوربین‌های افقی روی دستگاه، عمودی است. بسیاری از برنامه‌ها این وضعیت را مدیریت نمی‌کنند و تصاویر را به صورت کشیده نمایش می‌دهند.

مورد استفاده یا زمینه
چرخش و برش تصویر با 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 مراجعه کنید.

پس‌زمینه و رابط کاربری

این بخش تمام تنظیمات پیکربندی اعمال شده بر روی سطح لایه letterbox برای سفارشی‌سازی رابط کاربری یا در سطح فعالیت را فهرست می‌کند.

نام مکان نوع پیش‌فرض
config_letterboxActivityCornersRadius frameworks/base/core/res/res/values/config.xml Integer 0
توضیحات
شعاع گوشه را برای فعالیتی که در حالت letterbox ارائه می‌شود، پیکربندی می‌کند. مقادیر کمتر از 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
توضیحات
پیکربندی می‌کند که آیا ارسال فوکوس جعلی سازگاری برای فعالیت‌های از سر گرفته شده در حالت تقسیم صفحه نمایش فعال باشد یا خیر.
این امر ضروری است زیرا برخی از موتورهای بازی قبل از ترسیم محتوای برنامه، منتظر می‌مانند تا فوکوس (focus) به آنها داده شود، که به طور پیش‌فرض در حالت‌های چند پنجره‌ای ارائه نمی‌شود.

مورد استفاده یا زمینه
یک پرچم قدیمی برای اعمال سازگاری موتورهای بازی Unity برای برنامه‌هایی که پس از ورود به حالت تقسیم صفحه سیاه می‌شوند و فقط پس از ضربه زدن و تمرکز کاربر روی برنامه ترسیم می‌شوند.
config_letterboxBackgroundType frameworks/base/core/res/res/values/config.xml Integer 0
توضیحات
ظاهر گوشه‌ای پس‌زمینه‌ی کادر نامه را پیکربندی می‌کند:
  • 0 - پس‌زمینه‌ی یکدست با استفاده از رنگ مشخص شده در R.color.config_letterboxBackgroundColor .
  • 1 - رنگی که در R.attr.colorBackground برای برنامه‌ی letterboxed مشخص شده است.
  • 2 - رنگ مشخص شده در R.attr.colorBackgroundFloating برای برنامه با کادر حروفی.
  • 3 - تصویر زمینه با تاری کم رنگ یا خط تیره. حداقل یکی از پارامترهای زیر باید بزرگتر از 0 باشد: config_letterboxBackgroundWallpaperBlurRadius یا config_letterboxBackgroundWallpaperDarkScrimAlpha . اگر اینطور نباشد، یا اگر شعاع تاری ارائه شده باشد اما تاری توسط دستگاه پشتیبانی نشود و این گزینه انتخاب شود، پیاده‌سازی به طور پیش‌فرض روی گزینه 0 قرار می‌گیرد. اگر مقدار داده شده خارج از این محدوده باشد، گزینه 0 در نظر گرفته می‌شود.


مورد استفاده یا زمینه
این ویژگی به دلیل مشکلات عملکردی موجود راه‌اندازی نشده است. تولیدکنندگان اصلی تجهیزات (OEM) می‌توانند پیاده‌سازی خود را از این ویژگی ایجاد کنند، اما 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 انتخاب شده است و تاری درخواست می‌شود اما در دستگاه پشتیبانی نمی‌شود، یا هر دو پارامتر آلفای اسکریم تیره و شعاع تاری ارائه نمی‌شوند.


مورد استفاده یا زمینه
این ویژگی به دلیل مشکلات عملکردی موجود راه‌اندازی نشده است. تولیدکنندگان اصلی تجهیزات (OEM) می‌توانند پیاده‌سازی خود را از این ویژگی ایجاد کنند، اما AOSP هیچ گونه اشکالی را برطرف نمی‌کند.
config_letterboxBackgroundWallpaperBlurRadius frameworks/base/core/res/res/values/config.xml Dimen 38dp
توضیحات
شعاع محوشدگی را برای گزینه 3 در R.integer.config_letterboxBackgroundType پیکربندی می‌کند. مقادیر کمتر از 0 نادیده گرفته می‌شوند و 0 استفاده می‌شود.

مورد استفاده یا زمینه
این ویژگی به دلیل مشکلات عملکردی موجود راه‌اندازی نشده است. تولیدکنندگان اصلی تجهیزات (OEM) می‌توانند پیاده‌سازی خود را از این ویژگی ایجاد کنند، اما AOSP هیچ گونه اشکالی را برطرف نمی‌کند.
config_letterboxBackgroundWallpaperDarkScrimAlpha frameworks/base/core/res/res/values/config.xml Float 0.54
توضیحات
آلفای یک پارچه‌ی مشکی نیمه‌شفاف که روی پس‌زمینه‌ی کادر حروف تصویر زمینه نمایش داده می‌شود را پیکربندی می‌کند، زمانی که گزینه‌ی 3 برای R.integer.config_letterboxBackgroundType انتخاب شده باشد. مقادیر کمتر از 0 یا بزرگتر یا مساوی 1 نادیده گرفته می‌شوند و به جای آن 0.0 (شفاف) استفاده می‌شود.

مورد استفاده یا زمینه
این ویژگی به دلیل مشکلات عملکردی موجود راه‌اندازی نشده است. تولیدکنندگان اصلی تجهیزات (OEM) می‌توانند پیاده‌سازی خود را از این ویژگی ایجاد کنند، اما 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
توضیحات
موقعیت افقی پیش‌فرض پنجره برنامه با کادر حروفی را در صورت فعال بودن قابلیت دسترسی و تمام صفحه بودن برنامه در جهت افقی دستگاه و در حالت کتاب، پیکربندی می‌کند. وقتی قابلیت دسترسی فعال است، موقعیت می‌تواند بین چپ، وسط و راست تغییر کند:
  • گزینه 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
  • ۴:۳ - 3
  • ۱۶:۹ - 4
  • ۳:۲ - 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 جی‌سون دارایی پویای تاشو با اندازه افقی
توضیحات
یک تصویر 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
توضیحات
پیکربندی می‌کند که آیا کادر محاوره‌ای راه‌اندازی مجدد طولانی فعال باشد یا خیر.

مورد استفاده یا زمینه
برای یک مورد استفاده از دیالوگ راه‌اندازی مجدد طولانی، به شکل ۲ مراجعه کنید.
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
توضیحات
حداقل تلورانس درصد محدوده‌های فعالیت درون وظیفه خود را برای پنهان کردن دکمه راه‌اندازی مجدد سازگاری اندازه پیکربندی می‌کند. مقادیر کمتر از 0 یا بیشتر از 100 نادیده گرفته می‌شوند.
100 مقدار پیش‌فرض است که در آن فعالیت باید دقیقاً در داخل وظیفه قرار گیرد تا دکمه راه‌اندازی مجدد سازگاری اندازه پنهان شود. مقدار 0 به این معنی است که دکمه راه‌اندازی مجدد سازگاری اندازه همیشه پنهان است.

مورد استفاده یا زمینه
در دستگاه‌های تقریباً مربعی برای مخفی کردن دکمه‌ی راه‌اندازی مجدد، زمانی که برنامه‌های غیرقابل تغییر اندازه توسط کاربر چرخانده می‌شوند، استفاده می‌شود، اما راه‌اندازی مجدد برنامه، رابط کاربری را به طور چشمگیری بهبود نمی‌بخشد.

تصاویر زیر موارد استفاده از پوشش آموزشی را نشان می‌دهند:

آموزش Letterbox برای برنامه‌های تمام صفحه

شکل 1. آموزش Letterbox برای برنامه‌های تمام صفحه

نمونه‌ای از یک پنجره‌ی راه‌اندازی مجدد طولانی.

شکل ۲. پنجره‌ی راه‌اندازی مجدد گسترده

نمونه‌ای از آموزش دسترسی‌پذیری.

شکل ۳. آموزش دسترسی‌پذیری.

نمونه‌ای از دکمه‌ی راه‌اندازی مجدد بر اساس سازگاری اندازه.

شکل ۴. دکمه‌ی راه‌اندازی مجدد سازگاری اندازه.