Android 9 hỗ trợ thêm nhiều cách triển khai các loại vết cắt trên màn hình trên thiết bị. Vết cắt trên màn hình giúp bạn tạo trải nghiệm sống động, tràn viền mà vẫn có không gian cho những nội dung quan trọng các cảm biến ở mặt trước của thiết bị.
Hình 1. Vết cắt của màn hình chính giữa trên cùng
Android 9 hỗ trợ các loại vết cắt sau đây:
- Chính giữa trên cùng: Vết cắt ở chính giữa cạnh trên
- Chưa được nhập trên cùng: Vết cắt có thể nằm ở góc hoặc hơi lệch chính giữa
- Dưới cùng: Hình cắt ở dưới cùng
- Kép: 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
Mã trình quản lý cửa sổ sau đây tại
PhoneWindowManager.java
cho thấy cách khung hiển thị được lồng ghép vào vùng an toàn khi
Chưa đặt LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS.
// 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 kết xuất trong vùng cắt và cần xác định vị trí có thể vẽ. PhoneStatusBarView.java đưa ra ví dụ về một thành phần hiển thị giúp xác định vị trí của vết cắt trên màn hình, nó có kích thước lớn hay không và phần lồng ghép từ thanh điều hướng có tránh được vùng cắt hay không.
Bằng cách ghi đè onApplyWindowInsets(), 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 của nó 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ý các vết cắt trên thanh trạng thái trong mọi trường hợp (tức là chính giữa trên cùng, trên cùng chưa vào trong, dưới cùng và vết cắt kép trong tất cả các cách xoay).
Yêu cầu
Để đảm bảo các vết cắt không ảnh hưởng tiêu cực đến ứng dụng, bạn phải đảm bảo rằng:
- Thanh trạng thái mở rộng ít nhất tới chiều cao của vết cắt ở chế độ dọc
- Vùng cắt phải là 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 bước 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 cùng cho bảng điều khiển cài đặt nhanh. Đồng hồ và pin được hiển thị trong không gian phía trên bảng điều khiển. Trong vùng giá trị, 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 (chế độ cài đặt nhanh đã thu gọn khi ngăn thông báo được mở rộng, bao gồm cả không gian ở trên bảng điều khiển chứa đồng hồ.
Do cách bố trí trình đơn cài đặt nhanh, tổng chiều cao của
bảng điều khiển cài đặt nhanh (bao gồm cả vị trí bù trừ) phải được xác định theo phương thức tĩnh,
nên giá trị này phải được điều chỉnh theo cùng một delta
|
status_bar_height_portrait
|
Chiều cao mặc định của thanh trạng thái từ góc nhìn của khung. Trong hầu hết các thiết bị, giá trị mặc định là 24 dp. Khi có vết cắt, hãy thiết lập với chiều cao của vết cắt. Có thể cao hơn phần 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. Tính năng cắt bỏ chỉ được hỗ trợ trên các cạnh ngắn của thiết bị, nên trạng thái này sẽ luôn là không thay đổi chiều cao của thanh. Trên một thiết bị không có vết cắt, điều này tương đương với
|
config_mainBuiltInDisplayCutout
|
Đường dẫn xác định hình dạng của vết 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
|
Một giá trị boolean xác định xem có nên vẽ đường cắt vết cắt hay không (được xác định nêu trên) trong phần mềm. Có thể dùng để mô phỏng một vết cắt hoặc điền vào một vết cắt vật lý để có hiệu ứng khử răng cưa. Nếu đúng, |
Xem dimens tệp này để biết định nghĩa mặc định:
Lớp phủ mẫu cho vết cắt được 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 kiểm thử CTS tại tests/framework/base/windowmanager/src/android/server/wm.