W Androidzie 9 można stosować różne i typu wycięcia w ekranie. Wycięcia w ekranie umożliwiają tworzenie wciągające rozwiązania, zapewniając jednocześnie przestrzeń na ważne czujniki znajdujące się z przodu.
Rysunek 1. Wycięcie w ekranie u góry i na środku
Android 9 obsługuje te typy wycięć:
- U góry pośrodku: wycięcie na środku górnej krawędzi
- Niewyśrodkowany u góry: wycięcie może znajdować się w rogu lub jest trochę nieśrodkowe
- U dołu: wycięcie na dole
- Podwójne: jedno wycięcie u góry i jedno u dołu
Przykłady i źródło
Ten kod menedżera okien na stronie
PhoneWindowManager.java
pokazuje, jak ramki wyświetlane są w bezpiecznym obszarze, gdy
Wartość LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS nie jest ustawiona.
// 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);
}
Interfejs SystemUI renderuje się w obszarze wycięcia i musi określić, gdzie może go narysować. PhoneStatusBarView.java To przykład widoku, który określa, gdzie znajduje się wycięcie w ekranie, oraz niezależnie od tego, czy wcięcie w pasku nawigacyjnym omija obszar wycięcia.
Dzięki zastąpieniu parametru onApplyWindowInsets() widok może określić, gdzie znajduje się wycięcie
i odpowiednio dostosować jej układ.
@Override
public WindowInsets onApplyWindowInsets(WindowInsets insets) {
if (updateOrientationAndCutout(mLastOrientation)) {
updateLayoutForCutout();
requestLayout();
}
return super.onApplyWindowInsets(insets);
}
Te metody określają, jak obsługiwane są wycięcia na pasku stanu we wszystkich przypadkach (tj. u góry pośrodku, u góry niewyśrodkowany, na dole i z podwójnym wycięciem we wszystkich obrotach).
Wymagania
Aby na aplikacje nie wpływały wycięcia, sprawdź, które:
- Pasek stanu sięga co najmniej do wysokości wycięcia w trybie pionowym
- W trybie pełnoekranowym i poziomym obszar wycięcia musi być ustawiony na poziome pasy.
W urządzeniu może być maksymalnie 1 wycięcie na każdej krótszej krawędzi (u góry i na dole).
Więcej informacji znajdziesz w CDD.
Implementacja
Aby wdrożyć wycięcia w ekranie na urządzeniu, musisz skonfigurować te elementy: dla interfejsu systemowego.
| Wartość | Opis |
|---|---|
quick_qs_offset_height
|
Określa górny margines panelu szybkich ustawień. Zegar i bateria są wyświetlane w obszarze nad panelem. W polu wartości ustaw na |
quick_qs_total_height
|
Całkowita wysokość panelu szybkich ustawień (zwiniętego panelu szybkich ustawień) ), gdy obszar powiadomień jest rozszerzony, łącznie z obszarem powyżej na panelu z zegarem.
Ze względu na układ szybkich ustawień całkowita wysokość
panelu szybkich ustawień (łącznie z przesunięciem) musi być statycznie znany.
więc ta wartość musi być dostosowana o tę samą wartość delta
|
status_bar_height_portrait
|
Domyślna wysokość paska stanu z perspektywy platformy. Na większości urządzeń domyślna wartość to 24 dp. Jeśli jest wycięcie, ustaw ten na wysokość wycięcia. Opcjonalnie może być wyższy niż wycięcie w razie potrzeby. |
status_bar_height_landscape
|
Wysokość paska stanu w orientacji poziomej. Wycinki są obsługiwane tylko na tych urządzeniach: Krótsze krawędzie urządzenia, więc ten stan zawsze będzie niezmieniony. wysokość słupka. Na urządzeniu bez wycięcia jest to odpowiednik
|
config_mainBuiltInDisplayCutout
|
Ścieżka definiująca kształt wycięcia. To jest ciąg znaków, który może przeanalizować
W ścieżce można określić |
config_fillMainBuiltinDisplayCutout
|
Wartość logiczna określająca, czy należy narysować ścieżkę wycięcia (zdefiniowaną powyżej) w programie. Można jej używać do emulacji wycięcia lub wypełnienia fizyczne wycięcie, aby uzyskać wygładzanie. Jeśli ma wartość prawda, pole |
Definicję domyślnych znajdziesz w tych plikach dimens:
Przykładowa nakładka z emulowanym wycięciem:
<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>
Weryfikacja
Aby sprawdzić poprawność implementacji wycięć w ekranie, uruchom testy CTS na stronie tests/framework/base/windowmanager/src/android/server/wm.