Android 9 bổ sung khả năng hỗ trợ triển khai nhiều loại vết cắt trên màn hình trên các thiết bị. Vết cắt trên màn hình cho phép bạn tạo ra trải nghiệm sống động, tràn viền trong khi vẫn có không gian cho các cảm biến quan trọng ở mặt trước của thiết bị.
Hình 1. Vết cắt trên màn hình ở trên cùng và ở giữa
Android 9 hỗ trợ các loại vết cắt sau:
- Chính giữa trên cùng: Vết cắt ở giữa cạnh trên cùng
- Phần trên không nằm ở giữa: Vết cắt có thể nằm ở góc hoặc hơi lệch tâm
- Dưới cùng: Vết cắt ở dưới cùng
- Hai vết cắt: Một vết cắt ở trên cùng và một vết cắt ở dưới cùng
Ví dụ và nguồn
Đoạn mã trình quản lý cửa sổ sau đây tại PhoneWindowManager.java cho biết cách khung hiển thị được chèn vào vùng an toàn khi LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS
chưa được đặt.
// Ensure that windows with a DEFAULT or NEVER display cutout mode are laid out in
// the cutout safe zone.
if (cutoutMode != LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS) {
final Rect displayCutoutSafeExceptMaybeBars = mTmpDisplayCutoutSafeExceptMaybeBarsRect;
displayCutoutSafeExceptMaybeBars.set(displayFrames.mDisplayCutoutSafe);
if (layoutInScreen && layoutInsetDecor && !requestedFullscreen
&& cutoutMode == LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT) {
// At the top we have the status bar, so apps that are
// LAYOUT_IN_SCREEN | LAYOUT_INSET_DECOR but not FULLSCREEN
// already expect that there's an inset there and we don't need to exclude
// the window from that area.
displayCutoutSafeExceptMaybeBars.top = Integer.MIN_VALUE;
}
if (layoutInScreen && layoutInsetDecor && !requestedHideNavigation
&& cutoutMode == LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT) {
// Same for the navigation bar.
switch (mNavigationBarPosition) {
case NAV_BAR_BOTTOM:
displayCutoutSafeExceptMaybeBars.bottom = Integer.MAX_VALUE;
break;
case NAV_BAR_RIGHT:
displayCutoutSafeExceptMaybeBars.right = Integer.MAX_VALUE;
break;
case NAV_BAR_LEFT:
displayCutoutSafeExceptMaybeBars.left = Integer.MIN_VALUE;
break;
}
}
if (type == TYPE_INPUT_METHOD && mNavigationBarPosition == NAV_BAR_BOTTOM) {
// The IME can always extend under the bottom cutout if the navbar is there.
displayCutoutSafeExceptMaybeBars.bottom = Integer.MAX_VALUE;
}
// Windows that are attached to a parent and laid out in said parent already avoid
// the cutout according to that parent and don't need to be further constrained.
// Floating IN_SCREEN windows get what they ask for and lay out in the full screen.
// They will later be cropped or shifted using the displayFrame in WindowState,
// which prevents overlap with the DisplayCutout.
if (!attachedInParent && !floatingInScreenWindow) {
mTmpRect.set(pf);
pf.intersectUnchecked(displayCutoutSafeExceptMaybeBars);
parentFrameWasClippedByDisplayCutout |= !mTmpRect.equals(pf);
}
// Make sure that NO_LIMITS windows clipped to the display don't extend under the
// cutout.
df.intersectUnchecked(displayCutoutSafeExceptMaybeBars);
}
SystemUI hiển thị trong vùng vết cắt và cần xác định vị trí có thể vẽ. PhoneStatusBarView.java cung cấp ví dụ về một khung hiển thị xác định vị trí của vết cắt trên màn hình, kích thước của vết cắt và liệu phần lồng ghép từ thanh điều hướng có tránh được vùng vết cắt hay không.
Bằng cách ghi đè onApplyWindowInsets()
, một khung hiển thị có thể xác định vị trí của vết cắt và cập nhật bố cục cho phù hợp.
@Override
public WindowInsets onApplyWindowInsets(WindowInsets insets) {
if (updateOrientationAndCutout(mLastOrientation)) {
updateLayoutForCutout();
requestLayout();
}
return super.onApplyWindowInsets(insets);
}
Các phương thức này trình bày cách xử lý vết cắt trên thanh trạng thái trong mọi trường hợp (tức là ở giữa trên cùng, không ở giữa trên cùng, dưới cùng và vết cắt kép ở mọi hướng xoay).
Yêu cầu
Để đảm bảo các ứng dụng không bị ảnh hưởng tiêu cực bởi vết cắt, bạn phải đảm bảo rằng:
- Thanh trạng thái mở rộng ít nhất bằng chiều cao của vết cắt ở chế độ dọc
- Vùng vết cắt phải có dạng hòm thư ở chế độ toàn màn hình và chế độ ngang
Thiết bị của bạn có thể có tối đa một vết cắt trên mỗi cạnh ngắn (trên cùng và dưới cùng).
Để biết thêm thông tin, hãy xem CDD.
Triển khai
Để triển khai vết cắt trên màn hình trên thiết bị, bạn phải định cấu hình các giá trị sau cho Giao diện người dùng hệ thống.
Giá trị | Mô tả |
---|---|
quick_qs_offset_height
|
Xác định lề trên cho bảng cài đặt nhanh. Đồng hồ và pin xuất hiện ở phía trên bảng điều khiển. Trong values-land, hãy đặt thành |
quick_qs_total_height
|
Tổng chiều cao của bảng điều khiển cài đặt nhanh (bảng điều khiển cài đặt nhanh ở trạng thái thu gọn) khi ngăn thông báo được mở rộng, bao gồm cả khoảng trống phía trên bảng điều khiển chứa đồng hồ.
Do cách bố trí của phần cài đặt nhanh, bạn phải biết trước tổng chiều cao của bảng điều khiển cài đặt nhanh (bao gồm cả độ lệch), vì vậy, bạn phải điều chỉnh giá trị này theo cùng một delta |
status_bar_height_portrait
|
Chiều cao mặc định của thanh trạng thái theo góc độ của khung. Trong hầu hết các thiết bị, giá trị này mặc định là 24 dp. Khi có vết cắt, hãy đặt giá trị này thành chiều cao của vết cắt. Có thể cao hơn vết cắt (không bắt buộc) nếu muốn. |
status_bar_height_landscape
|
Chiều cao của thanh trạng thái ở chế độ ngang. Vết cắt chỉ được hỗ trợ trên các cạnh ngắn của thiết bị, vì vậy, đây sẽ luôn là chiều cao thanh trạng thái không thay đổi. Trên thiết bị không có vết cắt, giá trị này tương đương với |
config_mainBuiltInDisplayCutout
|
Đường dẫn xác định hình dạng của phần cắt. Đây là một chuỗi có thể phân tích cú pháp bằng Bạn có thể chỉ định |
config_fillMainBuiltinDisplayCutout
|
Giá trị boolean xác định xem có vẽ đường cắt (được xác định ở trên) trong phần mềm hay không. Có thể dùng để mô phỏng một vết cắt hoặc để lấp đầy một vết cắt vật lý nhằm đạt được hiệu ứng khử răng cưa. Nếu đúng, |
Hãy xem các tệp dimens
này để biết định nghĩa mặc định:
Ví dụ về lớp phủ cho một vết cắt mô phỏng:
<resources xmlns:xliff="urn:oasis:names:tc:xliff:document:1.2">
<!-- The bounding path of the cutout region of the main built-in display.
Must either be empty if there is no cutout region, or a string that is parsable by
{@link android.util.PathParser}.
The path is assumed to be specified in display coordinates with pixel units and in
the display's native orientation, with the origin of the coordinate system at the
center top of the display.
To facilitate writing device-independent emulation overlays, the marker `@dp` can be
appended after the path string to interpret coordinates in dp instead of px units.
Note that a physical cutout should be configured in pixels for the best results.
-->
<string translatable="false" name="config_mainBuiltInDisplayCutout">
M 0,0
L -48, 0
L -44.3940446283, 36.0595537175
C -43.5582133885, 44.4178661152 -39.6, 48.0 -31.2, 48.0
L 31.2, 48.0
C 39.6, 48.0 43.5582133885, 44.4178661152 44.3940446283, 36.0595537175
L 48, 0
Z
@dp
</string>
<!-- Whether the display cutout region of the main built-in display should be forced to
black in software (to avoid aliasing or emulate a cutout that is not physically existent).
-->
<bool name="config_fillMainBuiltInDisplayCutout">true</bool>
<!-- Height of the status bar -->
<dimen name="status_bar_height_portrait">48dp</dimen>
<dimen name="status_bar_height_landscape">28dp</dimen>
<!-- Height of area above QQS where battery/time go (equal to status bar height if > 48dp) -->
<dimen name="quick_qs_offset_height">48dp</dimen>
<!-- Total height of QQS (quick_qs_offset_height + 128) -->
<dimen name="quick_qs_total_height">176dp</dimen>
</resources>
Xác nhận kết quả
Để xác thực việc triển khai vết cắt trên màn hình, hãy chạy các kiểm thử CTS tại tests/framework/base/windowmanager/src/android/server/wm.