Display-Aussparungen

Android 9 unterstützt die Implementierung verschiedener Arten von Display-Aussparungen auf Geräten. Mit Display-Aussparungen können immersive, Edge-to-Edge-Inhalte zu erleben und gleichzeitig Raum für wichtige auf der Vorderseite der Geräte.

Display-Aussparung oben in der Mitte

Abbildung 1: Display-Aussparung oben in der Mitte

Android 9 unterstützt die folgenden Arten von Aussparungen:

  • Oben Mitte: Aussparung in der Mitte der Oberkante
  • Oben nicht mittig: Der Ausschnitt befindet sich möglicherweise in der Ecke oder nicht mittig
  • Unten: Aussparung unten
  • Dual: Eine Aussparung oben und eine Aussparung unten

Beispiele und Quelle

Der folgende Fenstermanager-Code unter PhoneWindowManager.java zeigt, wie Displayframes in den sicheren Bereich eingefügt werden, LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS ist nicht festgelegt.

// 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 wird im Aussparungsbereich gerendert und muss festlegen, wo gezeichnet werden kann. PhoneStatusBarView.java. zeigt ein Beispiel für eine Ansicht, in der festgelegt wird, wo sich die Display-Aussparung befindet, wie und ob der Einsatz der Navigationsleiste den Aussparungsbereich vermeidet.

Durch das Überschreiben von onApplyWindowInsets() kann eine Ansicht bestimmen, wo sich die Aussparung befindet und aktualisieren das Layout entsprechend.

@Override
    public WindowInsets onApplyWindowInsets(WindowInsets insets) {
        if (updateOrientationAndCutout(mLastOrientation)) {
            updateLayoutForCutout();
            requestLayout();
        }
        return super.onApplyWindowInsets(insets);
    }

Mit diesen Methoden wird in allen Fällen in der Statusleiste angegeben, wie Aussparungen gehandhabt werden. (d.h. oben mittig, oben nicht zentriert, unten und zwei Aussparungen in allen Drehungen).

Voraussetzungen

Damit Apps nicht durch Aussparungen beeinträchtigt werden, müssen Sie Folgendes beachten: dass:

  • Im Hochformat wird die Statusleiste mindestens auf die Höhe der Aussparung erweitert.
  • Der Aussparungsbereich muss im Vollbild und im Querformat mit Letterbox-Balken dargestellt werden.

Dein Gerät kann an jeder kurzen Seite (oben und unten) bis zu eine Aussparung haben.

Weitere Informationen finden Sie in der CDD-Datei.

Implementierung

Um Display-Aussparungen auf Ihrem Gerät zu implementieren, müssen Sie Folgendes konfigurieren: für die System-UI.

Wert Beschreibung
quick_qs_offset_height

Definiert den oberen Rand für den Bereich mit den Schnelleinstellungen. Uhr und Akku werden oben im Steuerfeld angezeigt.

Legen Sie unter „Werte-Land“ den Wert status_bar_height_landscape fest und Hochformat entweder auf die Standardeinstellung 48 dp oder auf die Höhe der Aussparung festgelegt. je nachdem, welcher Wert größer ist. Kann optional höher als die Aussparung sein, wenn erwünscht ist.

quick_qs_total_height

Gesamthöhe des Bereichs für Schnelleinstellungen (minimierte Schnelleinstellungen) Steuerfeld), wenn die Benachrichtigungsleiste maximiert ist, einschließlich des Bereichs darüber das Steuerfeld mit der Uhr.

Aufgrund der Anordnung der Schnelleinstellungen ist die Gesamthöhe der muss statisch, also statisch, bekannt sein. Dieser Wert muss also um das gleiche Delta quick_qs_offset_height Der Standardwert ist 152 dp. Das Hochformat beträgt standardmäßig 176 dp.

status_bar_height_portrait

Die Standardhöhe der Statusleiste aus Sicht des Frameworks.

Bei den meisten Geräten ist die Standardeinstellung 24 dp. Wenn es eine Aussparung gibt, legen Sie Folgendes fest: auf die Höhe der Aussparung. Kann optional höher als die Aussparung sein falls gewünscht.

status_bar_height_landscape

Höhe der Statusleiste im Querformat Aussparungen werden nur unterstützt auf an den kurzen Rändern des Geräts ab, sodass der Status immer unverändert bleibt. Balkenhöhe.

Bei einem Gerät ohne Aussparung entspricht dies der status_bar_height_portrait Wenn eine Aussparung vorhanden ist, auf die Standardhöhe der Statusleiste.

config_mainBuiltInDisplayCutout

Pfad, der die Form der Aussparung definiert. Dies ist ein String, der von android.util.PathParser. Er gibt an, wie Größe und Form des Elements wird für das System definiert.

@dp kann im Pfad angegeben werden, um das Targeting einer Form zu emulieren auf unterschiedlichen Geräten. Da physische Aussparungen eine exakte Pixelgröße haben, den Bezeichner @dp nicht verwenden, wenn Sie den Pfad für einen

config_fillMainBuiltinDisplayCutout

Boolescher Wert, der bestimmt, ob der Ausschneidepfad (definiert oben) in Software. Kann verwendet werden, um eine Aussparung zu emulieren oder eine für die Kantenglättung verwendet wird.

Falls wahr, wird config_mainBuiltInDisplayCutout ausgefüllt Schwarz.

Die Standarddefinitionen finden Sie in diesen dimens-Dateien:

Beispiel-Overlay für eine emulierte Aussparung:

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

Zertifizierungsstufe

Um die Implementierung der Display-Aussparungen zu überprüfen, führen Sie die CTS-Tests unter tests/framework/base/windowmanager/src/android/server/wm