Große aufgeklappte Displays und einzigartige Klappzustände ermöglichen neue Nutzererfahrungen auf faltbaren Geräten. Wenn du deine App in Jetpack Compose für faltbare Geräte optimieren möchtest, verwende die Compose Material 3 Adaptive-Bibliothek. Sie bietet APIs für Fensterfunktionen faltbarer Geräte wie Falten, Scharniere und Gerätehaltungen. Wenn deine App faltbar ist, kann sie ihr Layout so anpassen, dass wichtige Inhalte nicht im Bereich von Falten oder Scharnieren platziert werden. Falten und Scharniere können als natürliche Trennlinien verwendet werden.
Wenn du weißt, ob ein Gerät Konfigurationen wie den Tisch- oder Buchmodus unterstützt, kannst du Entscheidungen darüber treffen, ob du verschiedene Layouts unterstützen oder bestimmte Funktionen bereitstellen möchtest.
Fensterinformationen
Verwenden Sie in Jetpack Compose die zusammensetzbare Funktion collectFoldingFeaturesAsState(), um Informationen zum Falten des Fensters zu beobachten.
collectFoldingFeaturesAsState() erfasst die aktuellen Faltfunktionen des Fensters aus WindowInfoTracker in einem Compose-State, das eine Liste von FoldingFeature-Objekten enthält.
Da collectFoldingFeaturesAsState() ein Compose-State zurückgibt, werden Ihre Composables automatisch neu zusammengesetzt, wenn sich der Faltstatus oder die Position des Geräts ändert. Eine manuelle Lebenszyklusverwaltung oder Flow-Erfassung ist nicht erforderlich:
@Composable
fun FoldAwareScreen() {
val foldingFeatures by collectFoldingFeaturesAsState()
// Access folding features for the current window.
val foldFeature = foldingFeatures.firstOrNull()
if (foldFeature != null) {
// Adapt layout based on the fold feature.
}
}
Funktionen von faltbaren Displays
Die Liste der FoldingFeature-Elemente, die von collectFoldingFeaturesAsState() (einem Untertyp von DisplayFeature) zurückgegeben wird, enthält Informationen zu faltbaren Displays, darunter die folgenden Eigenschaften:
state: Der Klappstatus des Geräts,FLAToderHALF_OPENEDorientation: Die Ausrichtung des Falzes oder Scharniers,HORIZONTALoderVERTICALocclusionType: Gibt an, ob der Falz oder das Scharnier einen Teil des Displays verdeckt,NONEoderFULLisSeparating: Gibt an, ob durch das Falten oder das Scharnier zwei logische Displaybereiche entstehen (true oder false)
Bei einem faltbaren Gerät, das HALF_OPENED ist, wird isSeparating immer als „true“ gemeldet, da der Bildschirm in zwei Anzeigebereiche unterteilt ist. Außerdem ist isSeparating auf einem Dual-Screen-Gerät immer „true“, wenn die Anwendung auf beiden Bildschirmen angezeigt wird.
Die FoldingFeature-Eigenschaft bounds (von DisplayFeature übernommen) stellt das Begrenzungsrechteck eines Klappelements wie einer Falte oder eines Scharniers dar.
Anhand der Grenzen können Elemente auf dem Bildschirm relativ zum Element positioniert werden:
@Composable
fun FoldFeatureDemo() {
val foldingFeatures by collectFoldingFeaturesAsState()
val foldFeature = foldingFeatures.firstOrNull()
if (foldFeature != null) {
val isSeparating = foldFeature.isSeparating
val occlusionType = foldFeature.occlusionType
val bounds = foldFeature.bounds
// Use bounds and properties to position content.
}
}
Auf dem Tisch
Anhand der Informationen im FoldingFeature-Objekt kann deine App Positionen wie „Auf dem Tisch“ unterstützen, bei der das Smartphone auf einer Oberfläche liegt, das Scharnier horizontal ausgerichtet ist und das faltbare Display halb geöffnet ist.
Im Modus „Auf dem Tisch“ können Nutzer ihr Smartphone bedienen, ohne es in der Hand halten zu müssen. Die Position „Auf dem Tisch“ eignet sich hervorragend zum Ansehen von Medien, Aufnehmen von Fotos und für Videoanrufe.
Verwende FoldingFeature.State und FoldingFeature.Orientation aus collectFoldingFeaturesAsState(), um festzustellen, ob sich das Gerät im Tischmodus befindet:
@Composable
fun TabletopContent() {
val foldingFeatures by collectFoldingFeaturesAsState()
val foldFeature = foldingFeatures.firstOrNull()
val isTableTopPosture = foldFeature != null &&
foldFeature.state == FoldingFeature.State.HALF_OPENED &&
foldFeature.orientation == FoldingFeature.Orientation.HORIZONTAL
if (isTableTopPosture) {
// Tabletop layout: separate content and controls across the fold.
} else {
// Standard layout.
}
}
Alternativ kannst du prüfen, ob sich das Fenster im Tischmodus befindet, indem du das von currentWindowAdaptiveInfoV2() zurückgegebene Attribut Posture prüfst:
val adaptiveInfo = currentWindowAdaptiveInfoV2()
val isTabletop = adaptiveInfo.windowPosture.isTabletop
Sobald du weißt, dass sich das Gerät im Tabletop-Modus befindet, aktualisiere das App-Layout entsprechend. Bei Medien-Apps bedeutet das in der Regel, dass die Wiedergabe im sichtbaren Bereich platziert wird und die Steuerelemente und ergänzenden Inhalte direkt darunter positioniert werden, um eine freihändige Wiedergabe zu ermöglichen.
Beispiele
MediaPlayerActivity-App: Hier erfahren Sie, wie Sie mit Media3 Exoplayer und WindowManager einen Videoplayer erstellen, der auf das Falten des Geräts reagiert.Medieninhalte für verschiedene Formfaktoren skalieren: Hier erfahren Sie, wie Sie in Jetpack Compose mit Media3 mit Fenstereinzügen, dynamischer Fenstergröße und Inhaltsskalierung umgehen.
Kamera-App auf faltbaren Geräten mit Jetpack WindowManager optimieren (Codelab): Hier erfährst du, wie du den Tischmodus für Foto-Apps implementierst. Der Sucher wird in der oberen Hälfte des Displays (über dem Falz) und die Steuerelemente in der unteren Hälfte angezeigt.
Buchstatus
Eine weitere einzigartige Funktion von faltbaren Geräten ist der Buchmodus, bei dem das Gerät halb geöffnet und das Scharnier vertikal ist. Die Buchhaltung eignet sich hervorragend zum Lesen von E‑Books. Mit einem zweiseitigen Layout auf einem großen Display, das wie ein gebundenes Buch aufgeklappt ist, wird das Lesen eines echten Buchs simuliert.
Du kannst ihn auch für die Fotografie verwenden, wenn du ein anderes Seitenverhältnis aufnehmen möchtest, während du Fotos per Sprachbefehl machst.
Die Buchhaltung wird mit denselben Techniken wie die Tischhaltung implementiert. Prüfen Sie, ob die Ausrichtung des Klappmechanismus vertikal statt horizontal ist:
@Composable
fun BookContent() {
val foldingFeatures by collectFoldingFeaturesAsState()
val foldFeature = foldingFeatures.firstOrNull()
val isBookPosture = foldFeature != null &&
foldFeature.state == FoldingFeature.State.HALF_OPENED &&
foldFeature.orientation == FoldingFeature.Orientation.VERTICAL
if (isBookPosture) {
// Book posture layout: two-page layout across the vertical fold.
} else {
// Standard single-page layout.
}
}
Änderungen der Fenstergröße
Der Anzeigebereich einer App kann sich aufgrund einer Änderung der Gerätekonfiguration ändern, z. B. wenn das Gerät auf- oder zugeklappt, gedreht oder im Mehrfenstermodus in der Größe angepasst wird.
Wenn Sie die aktuelle Fenstergrößenklasse abrufen und an Größenänderungen in Jetpack Compose anpassen möchten, verwenden Sie die zusammensetzbare Funktion currentWindowAdaptiveInfoV2() aus der Compose Material 3 Adaptive-Bibliothek. currentWindowAdaptiveInfoV2() gibt eine WindowAdaptiveInfo-Instanz zurück, die die WindowSizeClass des aktuellen Fensters (standardmäßig mit Unterstützung für große und extragroße Haltepunkte) sowie die windowPosture des Geräts bereitstellt:
@Composable
fun AdaptiveApp() {
val adaptiveInfo = currentWindowAdaptiveInfoV2()
val windowSizeClass = adaptiveInfo.windowSizeClass
when {
windowSizeClass.isWidthAtLeastBreakpoint(
WIDTH_DP_EXPANDED_LOWER_BOUND
) -> {
// Expanded layout
}
windowSizeClass.isWidthAtLeastBreakpoint(
WIDTH_DP_MEDIUM_LOWER_BOUND
) -> {
// Medium layout
}
else -> {
// Compact layout
}
}
}
Weitere Informationen finden Sie unter Fenstergrößenklassen verwenden.
Zusätzliche Ressourcen
Weitere Informationen zu faltbaren Geräten und Layouts, die auf das Falten reagieren, finden Sie in den folgenden Ressourcen:
Beispiele
- Jetpack WindowManager-Beispiel: Beispiel für die Verwendung der Jetpack WindowManager-Bibliothek
- Jetcaster: Implementierung des Tabletop-Modus mit Compose
Codelabs
- Programmieren für faltbare Smartphones und Geräte mit zwei Displays mit Jetpack WindowManager
- Kamera-App auf faltbaren Geräten mit Jetpack WindowManager optimieren