Vết cắt trên màn hình

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ị.

Vết cắt trên màn hình ở trên cùng và ở giữa

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 status_bar_height_landscape và ở chế độ dọc, hãy đặt thành giá trị mặc định là 48dp hoặc chiều cao của vết cắt, tuỳ theo giá trị nào lớn hơn. Có thể cao hơn vết cắt nếu muốn (không bắt buộc).

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 quick_qs_offset_height. Giá trị-land mặc định là 152dp, trong khi giá trị mặc định cho hướng dọc là 176dp.

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 status_bar_height_portrait. Khi có vết cắt, hãy giữ giá trị này ở chiều cao mặc định của thanh trạng thá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 android.util.PathParser và là cách hệ thống xác định kích thước và hình dạng của vết cắt.

Bạn có thể chỉ định @dp trên đường dẫn để mô phỏng một hình dạng nhắm đến các thiết bị khác nhau. Vì vết cắt thực tế có kích thước chính xác theo pixel, nên bạn không được dùng bộ chỉ định @dp khi xác định đường dẫn cho một vết cắt trên phần cứng.

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, config_mainBuiltInDisplayCutout sẽ được tô màu đen.

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.