Hướng dẫn thiết lập khả năng tương thích của ứng dụng trên màn hình lớn

Trang này cung cấp hướng dẫn thiết lập toàn diện và chỉ mục cho các lớp phủ cấu hình khả năng tương thích của ứng dụng Android trên màn hình lớn.

Màn hình

Phần này liệt kê tất cả các chế độ cài đặt cấu hình ảnh hưởng đến cấu hình ở cấp hiển thị.

Tên Vị trí Loại Mặc định
ignoreOrientationRequest display_settings.xml config false
true cho màn hình lớn (>= 600 dp)
Nội dung mô tả
Cho phép người dùng xoay miễn phí các hoạt động có hướng cố định trên màn hình được chỉ định.
Ví dụ: 
          <display-settings>
              <config identifier="0" />
              <display
                  name="<display's uniqueId>"
                  ignoreOrientationRequest="true"/>
          </display-settings>

Trường hợp sử dụng hoặc bối cảnh
Màn hình bỏ qua hướng mà tất cả ứng dụng yêu cầu và ứng dụng sẽ có dạng hòm thư.
Được dùng trên mọi thiết bị màn hình lớn và Android Automotive OS. Đây là chế độ mặc định cho tất cả các thiết bị màn hình lớn có smallestScreenWidthDp >= 600dp trong Android 16 trở lên.
config_letterboxIsDisplayRotationImmersiveAppCompatPolicyEnabled frameworks/base/core/res/res/values/config.xml Bool false
Nội dung mô tả
Cho phép chính sách tương thích xoay cho các ứng dụng sống động. Chính sách này ngăn tính năng tự động xoay sang hướng màn hình không tối ưu khi ở chế độ toàn màn hình. Điều này là cần thiết vì các ứng dụng sống động (chẳng hạn như trò chơi) thường không được tối ưu hoá cho mọi hướng và có thể có trải nghiệm người dùng kém khi xoay. Ngoài ra, một số trò chơi dựa vào cảm biến để chơi, vì vậy, người dùng có thể vô tình kích hoạt các chế độ xoay như vậy khi chế độ tự động xoay đang bật.
Chỉ áp dụng nếu ignoreOrientationRequest được bật.

Trường hợp sử dụng hoặc bối cảnh
Khoá hướng xoay cho các ứng dụng sống động.

Tỷ lệ khung hình

Phần này liệt kê tất cả chế độ cài đặt cấu hình ảnh hưởng đến cấu hình cửa sổ ở cấp hoạt động cho tỷ lệ khung hình.

Tên Vị trí Loại Mặc định
config_fixedOrientationLetterboxAspectRatio frameworks/base/core/res/res/values/config.xml Float 0.0
Nội dung mô tả
Định cấu hình tỷ lệ khung hình của hiệu ứng hòm thư cho hướng cố định. Hệ thống sẽ bỏ qua các giá trị nhỏ hơn hoặc bằng 1.0.

Trường hợp sử dụng hoặc bối cảnh
Định cấu hình tỷ lệ khung hình mặc định của thiết bị hoạt động cho hầu hết các ứng dụng có hiệu ứng hòm thư. Thường có tỷ lệ khung hình gần với tỷ lệ khung hình vuông.
config_letterboxIsSplitScreenAspectRatioForUnresizableAppsEnabled frameworks/base/core/res/res/values/config.xml Bool false
Nội dung mô tả
Định cấu hình xem có sử dụng tỷ lệ khung hình chia đôi màn hình làm tỷ lệ khung hình mặc định cho các ứng dụng không thay đổi kích thước hay không.

Trường hợp sử dụng hoặc bối cảnh
Hầu hết các ứng dụng không thay đổi kích thước đều mong đợi bố cục điện thoại dạng thanh dọc.
config_letterboxIsDisplayAspectRatioForFixedOrientationLetterboxEnabled frameworks/base/core/res/res/values/config.xml Bool false
Nội dung mô tả
Định cấu hình xem có sử dụng tỷ lệ khung hình hiển thị làm tỷ lệ khung hình mặc định cho tất cả các ứng dụng có hiệu ứng hòm thư hay không.

Trường hợp sử dụng hoặc bối cảnh
Một cấu hình để sử dụng tỷ lệ khung hình hiển thị theo phương thức lập trình thay vì định cấu hình giá trị dấu phẩy động.

Camera

Phần này liệt kê tất cả các chế độ cài đặt cấu hình ảnh hưởng đến ứng dụng khi gọi lại onCameraOpened. Các chế độ cài đặt này có thể ảnh hưởng đến màn hình, hoạt động và cấu hình camera.

Tên Vị trí Loại Mặc định
config_isWindowManagerCameraCompatTreatmentEnabled frameworks/base/core/res/res/values/config.xml Bool false
Nội dung mô tả
Cho phép xử lý khả năng tương thích của camera đối với các vấn đề do sự không khớp về hướng giữa các vùng đệm của camera và cửa sổ ứng dụng.
Điều này bao gồm cả việc xoay bắt buộc các hoạt động có hướng cố định được kết nối với camera ở chế độ toàn màn hình và hiển thị chú thích ở chế độ chia đôi màn hình.
Bạn có thể tắt chế độ xử lý buộc xoay bằng chế độ ghi đè cho mỗi ứng dụng: OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION.

Trường hợp sử dụng hoặc bối cảnh
Khắc phục tình trạng bản xem trước của camera bị xoay bằng cách buộc xoay màn hình để khớp với hướng mà ứng dụng yêu cầu.
config_isWindowManagerCameraCompatSplitScreenAspectRatioEnabled frameworks/base/core/res/res/values/config.xml Bool false
Nội dung mô tả
Định cấu hình xem một hoạt động có sử dụng tỷ lệ khung hình chia đôi màn hình hay không khi bật chế độ xử lý khả năng tương thích với máy ảnh và hoạt động được kết nối với máy ảnh ở chế độ toàn màn hình.

Trường hợp sử dụng hoặc bối cảnh
Khắc phục tình trạng bản xem trước của camera bị kéo giãn bằng cách đóng khung hoạt động theo tỷ lệ khung hình giống như thanh kẹo.
Thường được dùng cùng với chế độ xử lý buộc xoay (config_isWindowManagerCameraCompatTreatmentEnabled và camera.enable_landscape_to_portrait) trên các thiết bị ngang để khắc phục các vấn đề về khả năng tương thích của camera bị kéo giãn bằng cách mô phỏng tỷ lệ khung hình giống như điện thoại dạng thanh dọc cho hoạt động.
camera.enable_landscape_to_portrait Thuộc tính hệ thống Bool false
Nội dung mô tả
CổngOVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT xử lý.
Buộc cắt và xoay đầu ra của camera 90 độ trên các camera có hướng tự nhiên là hướng ngang để mô phỏng hướng tự nhiên là hướng dọc. Hướng cảm biến của camera được báo cáo là hướng dọc cho tất cả camera ở chế độ ngang trên thiết bị. Nhiều ứng dụng không xử lý trường hợp này và hiện hình ảnh bị kéo giãn.

Trường hợp sử dụng hoặc bối cảnh
Cho phép HAL camera xử lý việc xoay và cắt. Để biết thêm thông tin về cách xử lý, hãy xem phần Xoay, cắt, thu phóng.
Thêm nội dung sau vào tệp mk của bạn tại thời điểm tạo bản dựng: PRODUCT_PROPERTY_OVERRIDES += camera.enable_landscape_to_portrait=true
Phương pháp xử lý này yêu cầu thiết bị hỗ trợ SCALER_ROTATE_AND_CROP trong HAL. Hãy xem CameraCharacteristics#SCALER_AVAILABLE_ROTATE_AND_CROP_MODES.
Để biết hướng dẫn về cách triển khai dành riêng cho HAL cho SCALER_ROTATE_AND_CROP, hãy xem metadata_definitions.xml.

Nền và giao diện người dùng

Phần này liệt kê tất cả các chế độ cài đặt cấu hình được áp dụng cho bề mặt của lớp hộp thư để tuỳ chỉnh giao diện người dùng hoặc ở cấp độ hoạt động.

Tên Vị trí Loại Mặc định
config_letterboxActivityCornersRadius frameworks/base/core/res/res/values/config.xml Integer 0
Nội dung mô tả
Định cấu hình bán kính góc cho một hoạt động được trình bày ở chế độ hộp thư. Các giá trị nhỏ hơn 0 cho phép các góc bo tròn có bán kính bằng giá trị tối thiểu giữa bán kính góc dưới cùng của thiết bị. Giá trị mặc định là 0 sẽ tắt logic góc bo tròn trong AppCompatLetterboxPolicy.

Trường hợp sử dụng hoặc bối cảnh
Thường được định cấu hình để khớp với các góc bo tròn của thiết bị thực.
config_letterboxIsEnabledForTranslucentActivities frameworks/base/core/res/res/values/config.xml Bool false
Nội dung mô tả
Định cấu hình xem có bật hành vi cụ thể cho hoạt động mờ có hiệu ứng hòm thư hay không.

Trường hợp sử dụng hoặc bối cảnh
Cho phép các hoạt động hoặc phương thức mờ có hiệu ứng hòm thư và bị hạn chế trong cấu hình hoạt động có hiệu ứng hòm thư. Chính sách này áp dụng ở TransparentPolicy.
config_isCompatFakeFocusEnabled frameworks/base/core/res/res/values/config.xml Bool false
Nội dung mô tả
Định cấu hình xem có bật tính năng gửi tiêu điểm giả tương thích cho các hoạt động tiếp tục ở chế độ chia đôi màn hình hay không.
Điều này là cần thiết vì một số công cụ phát triển trò chơi chờ lấy tiêu điểm rồi mới vẽ nội dung của ứng dụng. Nội dung này không được cung cấp theo mặc định ở chế độ nhiều cửa sổ.

Trường hợp sử dụng hoặc bối cảnh
Một cờ cũ để áp dụng phương pháp xử lý khả năng tương thích cho các công cụ phát triển trò chơi Unity đối với những ứng dụng chuyển sang màu đen sau khi chuyển sang chế độ chia đôi màn hình và chỉ được vẽ sau khi người dùng nhấn và lấy tiêu điểm ứng dụng.
config_letterboxBackgroundType frameworks/base/core/res/res/values/config.xml Integer 0
Nội dung mô tả
Định cấu hình giao diện góc của nền hòm thư:
  • 0 – Nền đồng nhất sử dụng màu được chỉ định trong R.color.config_letterboxBackgroundColor.
  • 1 – Màu được chỉ định trong R.attr.colorBackground cho ứng dụng có hiệu ứng hộp thư.
  • 2 – Màu được chỉ định trong R.attr.colorBackgroundFloating cho ứng dụng có hiệu ứng hòm thư.
  • 3 – Hình nền có hiệu ứng mờ hoặc lớp phủ tối. Ít nhất một trong các thông số sau phải lớn hơn 0: config_letterboxBackgroundWallpaperBlurRadius hoặc config_letterboxBackgroundWallpaperDarkScrimAlpha. Nếu không phải như vậy hoặc nếu bán kính làm mờ được cung cấp nhưng thiết bị không hỗ trợ tính năng làm mờ và bạn chọn chế độ này, thì chế độ triển khai sẽ mặc định là Lựa chọn 0. Nếu giá trị đã cho nằm ngoài phạm vi này, thì giả định là Lựa chọn 0.


Trường hợp sử dụng hoặc bối cảnh
Tính năng này chưa được ra mắt do các vấn đề hiện tại về hiệu suất. Các OEM có thể tự triển khai tính năng này, nhưng AOSP sẽ không xử lý bất kỳ lỗi nào.
config_letterboxBackgroundColor frameworks/base/core/res/res/values/config.xml Color @color/system_neutral1_1000
Nội dung mô tả
Định cấu hình màu của nền hộp thư nếu một trong các điều kiện sau là true:
  • Đã chọn lựa chọn 0 cho R.integer.config_letterboxBackgroundType.
  • Lựa chọn 1 được chọn cho R.integer.config_letterboxBackgroundType và R.attr.colorBackground không được chỉ định cho ứng dụng.
  • Lựa chọn 2 được chọn cho R.integer.config_letterboxBackgroundType và R.attr.colorBackgroundFloating không được chỉ định cho ứng dụng.
  • Lựa chọn 3 được chọn cho R.integer.config_letterboxBackgroundType và hiệu ứng làm mờ được yêu cầu nhưng không được hỗ trợ trên thiết bị, hoặc cả alpha của lớp phủ tối và bán kính làm mờ đều không được cung cấp.


Trường hợp sử dụng hoặc bối cảnh
Tính năng này chưa được ra mắt do các vấn đề hiện tại về hiệu suất. Các OEM có thể tự triển khai tính năng này, nhưng AOSP sẽ không xử lý bất kỳ lỗi nào.
config_letterboxBackgroundWallpaperBlurRadius frameworks/base/core/res/res/values/config.xml Dimen 38dp
Nội dung mô tả
Định cấu hình bán kính làm mờ cho Tuỳ chọn 3 trong R.integer.config_letterboxBackgroundType. Các giá trị nhỏ hơn 0 sẽ bị bỏ qua và 0 sẽ được dùng.

Trường hợp sử dụng hoặc bối cảnh
Tính năng này chưa được ra mắt do các vấn đề hiện tại về hiệu suất. Các OEM có thể tự triển khai tính năng này, nhưng AOSP sẽ không xử lý bất kỳ lỗi nào.
config_letterboxBackgroundWallpaperDarkScrimAlpha frameworks/base/core/res/res/values/config.xml Float 0.54
Description
Định cấu hình alpha của một lớp phủ mờ màu đen xuất hiện trên nền hộp thư hình nền khi bạn chọn Tuỳ chọn 3 cho R.integer.config_letterboxBackgroundType. Các giá trị nhỏ hơn 0 hoặc lớn hơn hoặc bằng 1 sẽ bị bỏ qua và 0.0 (trong suốt) sẽ được dùng thay thế.

Trường hợp sử dụng hoặc bối cảnh
Tính năng này chưa được ra mắt do các vấn đề hiện tại về hiệu suất. Các OEM có thể tự triển khai tính năng này, nhưng AOSP sẽ không xử lý bất kỳ lỗi nào.

Phạm vi tiếp cận và vị trí

Phần này liệt kê tất cả chế độ cài đặt cấu hình được áp dụng cho cấu hình cửa sổ ở cấp hoạt động để hỗ trợ tiếp cận.

Tên Vị trí Loại Mặc định
config_letterboxIsHorizontalReachabilityEnabled frameworks/base/core/res/res/values/config.xml Bool false
Nội dung mô tả
Định cấu hình xem có bật tính năng định vị lại khả năng tiếp cận theo chiều ngang cho các ứng dụng có dạng hòm thư ở chế độ cửa sổ toàn màn hình hay không.

Trường hợp sử dụng hoặc bối cảnh
Định vị lại ứng dụng dọc sang trái hoặc phải để dễ truy cập hơn.
config_letterboxHorizontalPositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.5
Nội dung mô tả
Định cấu hình vị trí ngang của tâm cửa sổ ứng dụng có hiệu ứng hòm thư.
0 tương ứng với bên trái màn hình và 1 tương ứng với bên phải.
Nếu giá trị đã cho nhỏ hơn 0 hoặc lớn hơn 1, thì giá trị đó sẽ bị bỏ qua. Đối với tư thế không phải tư thế sách, vị trí trung tâm (0.5) sẽ được dùng. Đối với tư thế sách, vị trí bên trái (0.0) được dùng.

Trường hợp sử dụng hoặc bối cảnh
Mặc định là ở giữa đối với ứng dụng có tỷ lệ khung hình dọc.
config_letterboxIsVerticalReachabilityEnabled frameworks/base/core/res/res/values/config.xml Bool false
Nội dung mô tả
Định cấu hình xem tính năng định vị lại khả năng tiếp cận theo chiều dọc có được bật cho các ứng dụng có hiệu ứng hòm thư ở chế độ cửa sổ toàn màn hình hay không.

Trường hợp sử dụng hoặc bối cảnh
Định vị lại một ứng dụng ở chế độ ngang lên trên cùng hoặc xuống dưới cùng để dễ dàng truy cập hơn.
config_letterboxVerticalPositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
Nội dung mô tả
Định cấu hình vị trí dọc của tâm cửa sổ ứng dụng có hiệu ứng hòm thư.
Giá trị 0 tương ứng với phía trên của màn hình và 1 tương ứng với phía dưới.
Nếu giá trị đã cho nhỏ hơn 0 hoặc lớn hơn 1, thì giá trị đó sẽ bị bỏ qua. Đối với chế độ không phải trên mặt bàn, vị trí trung tâm (0.5) sẽ được dùng. Đối với tư thế đặt trên bàn, vị trí trên cùng (0.0) được dùng.

Trường hợp sử dụng hoặc bối cảnh
Được định cấu hình ở chính giữa trong các thiết bị màn hình lớn cho một ứng dụng có hiệu ứng hòm thư ở chế độ ngang.
config_letterboxIsAutomaticReachabilityInBookModeEnabled frameworks/base/core/res/res/values/config.xml Bool false
Nội dung mô tả
Định cấu hình xem chế độ tự động định vị khả năng tiếp cận theo chiều ngang ở tư thế sách có được bật cho các ứng dụng có dạng hòm thư ở chế độ cửa sổ toàn màn hình hay không.

Trường hợp sử dụng hoặc bối cảnh
Cho phép một ứng dụng có dạng hòm thư ở hướng dọc di chuyển giữa bên trái và bên phải khi thiết bị có thể gập ở tư thế sách.
config_letterboxBookModePositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
Nội dung mô tả
Định cấu hình vị trí ngang của tâm cửa sổ ứng dụng dạng hòm thư khi ở tư thế sách.
0 tương ứng với bên trái màn hình và 1 tương ứng với bên phải. Nếu giá trị đã cho nhỏ hơn 0 hoặc lớn hơn 1, thì giá trị đó sẽ bị bỏ qua và vị trí bên trái (0.0) sẽ được dùng.

Trường hợp sử dụng hoặc bối cảnh
Hệ số nhân cho mức độ di chuyển vị trí của ứng dụng khi được định vị lại ở tư thế sách.
config_letterboxDefaultPositionForBookModeReachability frameworks/base/core/res/res/values/config.xml Integer 0
Nội dung mô tả
Định cấu hình vị trí ngang mặc định của cửa sổ ứng dụng có khung viền hòm thư khi khả năng tiếp cận được bật và ứng dụng ở chế độ toàn màn hình theo hướng ngang của thiết bị và ở tư thế trang sách. Khi bạn bật chế độ xem phạm vi đến được, vị trí có thể thay đổi giữa trái, giữa và phải:
  • Lựa chọn 0 – Trái
  • Lựa chọn 1 – Giữa
  • Lựa chọn 2 – Phải
Nếu giá trị đã cho nằm ngoài phạm vi này, thì tuỳ chọn 0 (bên trái) sẽ được giả định.

Trường hợp sử dụng hoặc bối cảnh
Vị trí mặc định mà ứng dụng được đặt ở chế độ sách.
config_letterboxTabletopModePositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
Nội dung mô tả
Định cấu hình vị trí dọc của tâm cửa sổ ứng dụng có hiệu ứng hòm thư khi ở tư thế đặt trên bàn.
Giá trị 0 tương ứng với phía trên của màn hình và 1 tương ứng với phía dưới. Nếu giá trị đã cho nhỏ hơn 0 hoặc lớn hơn 1, thì giá trị đó sẽ bị bỏ qua và vị trí trên cùng 0.0 sẽ được dùng.

Trường hợp sử dụng hoặc bối cảnh
Hệ số nhân cho biết vị trí của ứng dụng di chuyển bao nhiêu trên thiết bị có thể gập lại khi ở tư thế đặt trên bàn.
config_letterboxDefaultPositionForTabletopModeReachability frameworks/base/core/res/res/values/config.xml Integer 0
Nội dung mô tả
Định cấu hình vị trí dọc mặc định của cửa sổ ứng dụng có khung viền hòm thư khi khả năng tiếp cận được bật và ứng dụng ở chế độ toàn màn hình theo hướng dọc của thiết bị và ở tư thế trên bàn. Khi bạn bật chế độ thao tác bằng một tay, vị trí có thể thay đổi giữa trên cùng, ở giữa và dưới cùng. Cấu hình này xác định cấu hình mặc định:
  • Lựa chọn 0 – Hàng đầu
  • Lựa chọn 1 – Giữa
  • Lựa chọn 2 – Dưới cùng
Nếu giá trị đã cho nằm ngoài phạm vi này, thì tuỳ chọn 0 (trên cùng) sẽ được giả định.

Trường hợp sử dụng hoặc bối cảnh
Vị trí mặc định mà ứng dụng được đặt ở chế độ trên bàn.

Cài đặt

Phần này liệt kê tất cả các chế độ cài đặt cấu hình để tuỳ chỉnh và bật chế độ cài đặt tỷ lệ khung hình của người dùng trong phần Cài đặt > Ứng dụng > Tỷ lệ khung hình.

Tên Vị trí Loại Mặc định
config_appCompatUserAppAspectRatioSettingsIsEnabled frameworks/base/core/res/res/values/config.xml Bool false
Nội dung mô tả
Định cấu hình xem chế độ cài đặt ghi đè tỷ lệ khung hình cho mỗi người dùng ứng dụng có được bật hay không.

Trường hợp sử dụng hoặc bối cảnh
Bật tính năng cài đặt tỷ lệ khung hình trong phần Cài đặt > Ứng dụng > Tỷ lệ khung hình.
config_appCompatUserAppAspectRatioFullscreenIsEnabled frameworks/base/core/res/res/values/config.xml Bool false
Nội dung mô tả
Định cấu hình xem lựa chọn ghi đè toàn màn hình cho mỗi ứng dụng có được bật trong chế độ cài đặt tỷ lệ khung hình của người dùng hay không.

Trường hợp sử dụng hoặc bối cảnh
Bật lựa chọn Toàn màn hình trong tính năng chế độ cài đặt tỷ lệ khung hình của người dùng.
Chế độ cài đặt này bỏ qua các quy tắc hạn chế về khả năng đổi kích thước, tỷ lệ khung hình và hướng của ứng dụng.
config_userAspectRatioOverrideEntries packages/apps/Settings/res/values/config.xml string-array Theo mặc định, tất cả các lựa chọn đều được bật.
Nội dung mô tả
Định cấu hình màn hình cài đặt tỷ lệ khung hình của ứng dụng và các lựa chọn ghi đè tỷ lệ khung hình của người dùng. Phải có cùng độ dài và thứ tự với config_userAspectRatioOverrideValues.
Nếu thay đổi, hãy cập nhật cả logic Sao lưu và khôi phục để chọn giá trị gần nhất trong UserAspectRatioBackupManager.java.

Trường hợp sử dụng hoặc bối cảnh
Các mối liên kết cho chuỗi xuất hiện trong phần Cài đặt.
config_userAspectRatioOverrideValues packages/apps/Settings/res/values/config.xml integer-array Theo mặc định, tất cả các chuỗi AOSP đều được sử dụng.
Nội dung mô tả
Định cấu hình màn hình cài đặt tỷ lệ khung hình của ứng dụng và các lựa chọn ghi đè tỷ lệ khung hình của người dùng. Phải có cùng độ dài và thứ tự với config_userAspectRatioOverrideEntries. Các giá trị phải tương ứng với PackageManager.UserMinAspectRatio.
Nếu thay đổi, hãy cập nhật cả logic Sao lưu và khôi phục để chọn giá trị gần nhất trong UserAspectRatioBackupManager.java.

Trường hợp sử dụng hoặc bối cảnh
Mối liên kết cho các lựa chọn với phần phụ trợ PackageManager.UserMinAspectRatio:
  • Mặc định của ứng dụng – 0
  • Chia đôi màn hình – 1
  • Tỷ lệ khung hình hiển thị – 2
  • 4:3 – 3
  • 16:9 – 4
  • 3:2 – 5
  • Toàn màn hình – 6
Các đối tượng tĩnh có thể vẽ theo giao diện sáng packages/apps/Settings/res/drawable/ic_app_aspect_ratio_<option>.xml vector Thành phần có kích thước phù hợp với thiết bị có thể gập lại ở chế độ ngang
Nội dung mô tả
Định cấu hình các đối tượng có thể vẽ hiện có:


Trường hợp sử dụng hoặc bối cảnh
Hình ảnh tĩnh có giao diện sáng trong mỗi lựa chọn trong phần Cài đặt > Thông tin ứng dụng > Tỷ lệ khung hình.
Các đối tượng tĩnh có thể vẽ theo giao diện tối packages/apps/Settings/res/drawable-night/ic_app_aspect_ratio_<option>.xml vector Thành phần có kích thước phù hợp với thiết bị có thể gập lại ở chế độ ngang
Nội dung mô tả
Định cấu hình các đối tượng có thể vẽ hiện có:


Trường hợp sử dụng hoặc bối cảnh
Hình ảnh tĩnh có giao diện tối trong mỗi lựa chọn trong phần Cài đặt > Thông tin ứng dụng > Tỷ lệ khung hình.
Đối tượng có thể vẽ động
user_aspect_ratio_education.json		 packages/apps/Settings/res/raw/user_aspect_ratio_education.json JSON Thành phần linh động có kích thước màn hình gập ở chế độ ngang
Nội dung mô tả
Định cấu hình hình minh hoạ Lottie trong UserAspectRatioAppsPageProvider.

Trường hợp sử dụng hoặc bối cảnh
Ảnh động trong danh sách ứng dụng: Cài đặt > Ứng dụng > Tỷ lệ khung hình.

Giáo dục

Phần này liệt kê tất cả các chế độ cài đặt cấu hình để hướng dẫn người dùng về các tính năng tương thích của ứng dụng.

Tên Vị trí Loại Mặc định
config_letterboxIsEducationEnabled frameworks/base/core/res/res/values/config.xml Bool false
Nội dung mô tả
Định cấu hình xem tính năng hướng dẫn về chế độ hòm thư có được bật cho các ứng dụng toàn màn hình ở chế độ hòm thư hay không.

Trường hợp sử dụng hoặc bối cảnh
Xem hình 1 để biết trường hợp sử dụng tính năng hướng dẫn về chế độ hòm thư cho các ứng dụng toàn màn hình.
config_letterboxIsRestartDialogEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool false
Nội dung mô tả
Định cấu hình xem hộp thoại khởi động lại mở rộng có được bật hay không.

Trường hợp sử dụng hoặc bối cảnh
Xem hình 2 để biết trường hợp sử dụng hộp thoại khởi động lại mở rộng.
config_letterboxIsReachabilityEducationEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool false
Nội dung mô tả
Định cấu hình xem có bật thông tin giáo dục bổ sung về khả năng tiếp cận hay không.

Trường hợp sử dụng hoặc bối cảnh
Xem hình 3 để biết trường hợp sử dụng thông tin giáo dục về khả năng tiếp cận.
config_isSizeCompatRestartButtonEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool true
Nội dung mô tả
Định cấu hình xem nút khởi động lại chế độ tương thích kích thước có được bật hay không.

Trường hợp sử dụng hoặc bối cảnh
Nút khởi động lại để khởi động lại cấu hình cho các ứng dụng không đổi kích thước sau khi thay đổi kích thước cửa sổ, ví dụ: khi chuyển sang chế độ chia đôi màn hình hoặc xoay màn hình.
Hãy xem hình 4 để biết một trường hợp sử dụng nút khởi động lại chế độ tương thích với kích thước.
config_letterboxRestartButtonHideTolerance frameworks/base/libs/WindowManager/Shell/res/values/config.xml Integer 100
Description
Định cấu hình dung sai tối thiểu của tỷ lệ phần trăm ranh giới hoạt động trong tác vụ để ẩn nút khởi động lại chế độ tương thích kích thước. Các giá trị thấp hơn 0 hoặc cao hơn 100 sẽ bị bỏ qua.
100 là giá trị mặc định mà hoạt động phải hoàn toàn phù hợp với tác vụ để cho phép ẩn nút khởi động lại khả năng tương thích về kích thước. Giá trị 0 có nghĩa là nút khởi động lại để tương thích kích thước luôn bị ẩn.

Trường hợp sử dụng hoặc bối cảnh
Được dùng trong các thiết bị gần vuông để ẩn nút khởi động lại khi người dùng xoay các ứng dụng không thay đổi được kích thước, nhưng việc khởi động lại ứng dụng sẽ không cải thiện đáng kể giao diện người dùng.

Các hình ảnh sau đây minh hoạ các trường hợp sử dụng lớp phủ giáo dục:

Giáo dục về hiệu ứng hòm thư cho các ứng dụng toàn màn hình

Hình 1. Giáo dục về hiệu ứng hòm thư cho các ứng dụng toàn màn hình

Ví dụ về hộp thoại khởi động lại mở rộng.

Hình 2. Hộp thoại khởi động lại mở rộng

Ví dụ về thông tin giáo dục về khả năng tiếp cận.

Hình 3. Giáo dục về khả năng hỗ trợ tiếp cận.

Ví dụ về nút khởi động lại chế độ tương thích với kích thước.

Hình 4. Nút khởi động lại chế độ tương thích với kích thước.