Ihre 2D-Android-App für Mobilgeräte oder große Bildschirme funktioniert standardmäßig in Android XR und wird als 2D-Bereich im 3D-Raum angezeigt. Sie können Ihre bestehende 2D-Android-App um immersive XR-Funktionen erweitern und so von einer flachen Bildschirmoberfläche zu einer dynamischen 3D-Umgebung wechseln.
Beachten Sie diese wichtigen Grundsätze, wenn Sie Ihre Android-App in XR einbinden.
- Spatial-Funktionen: Android XR bietet eine Vielzahl von Spatial-Funktionen, die für Ihre App verfügbar sind. Sie müssen jedoch nicht jede einzelne Funktion implementieren. Implementieren Sie strategisch diejenigen, die die visuelle Hierarchie, die Layouts und die User Journeys Ihrer App ergänzen. Sie können benutzerdefinierte Umgebungen und mehrere Bereiche einbinden, um eine wirklich immersive Umgebung zu schaffen. In den Richtlinien für das räumliche UI-Design finden Sie Informationen zur optimalen Integration räumlicher Elemente.
- Adaptive UI: XR bietet Ihnen die Flexibilität, eine großzügige UI zu entwerfen, die sich nahtlos an eine unendliche Leinwand und frei skalierbare Fenster anpasst. Einer der wichtigsten Aspekte ist die Verwendung unserer Designrichtlinien für große Bildschirme, um das Layout Ihrer App für diese größere Umgebung zu optimieren. Auch wenn Ihre App derzeit nur für Mobilgeräte verfügbar ist, können Sie fesselnde Umgebungen nutzen, um die Nutzerfreundlichkeit zu verbessern. Eine für große Bildschirme optimierte Benutzeroberfläche ist jedoch eine der besten Möglichkeiten, Ihre App für Android XR zu optimieren.
- UI-Framework: Wir empfehlen, die Benutzeroberfläche mit Jetpack Compose for XR zu erstellen. Wenn Ihre App auf Ansichten basiert, lesen Sie den Artikel Mit Ansichten in XR arbeiten, um mehr über die Nutzung der Compose-Interoperabilität bei der Arbeit mit Ansichten zu erfahren, oder erwägen Sie, direkt mit der Jetpack SceneCore-Bibliothek zu arbeiten.
- Im Play Store veröffentlichen: So prüfst du, ob deine XR-optimierte App im Play Store gefunden werden kann:
- Du kannst deine App optimieren, indem du unnötige Funktionsanforderungen entfernst.
- Prüfe in der Google Play Console, ob deine App für die XR-Veröffentlichung deaktiviert ist, damit sie nicht aus den Suchergebnissen im Google Play Store ausgeschlossen wird.
2D-UI-Komponenten in 3D konvertieren
Wenn Sie diese Tipps befolgen, kann das einen großen Unterschied machen und Ihre App so wirken lassen, als wäre sie für XR optimiert.
- Kompatibilität mit großen Bildschirmen priorisieren: Die Benutzeroberfläche Ihrer App sollte den Designprinzipien für große Bildschirme entsprechen, damit Text und Inhalte in großen XR-Umgebungen optimal lesbar sind.
- Räumliche Funktionen strategisch einsetzen: Identifizieren Sie wichtige Momente in der User Journey Ihrer App, in denen die Einbindung räumlicher Funktionen die Nutzerfreundlichkeit verbessert, und nutzen Sie die einzigartigen Funktionen der Plattform.
- Räumliche Bereiche nutzerfreundlich platzieren: Wenn Sie Ihr Layout mit räumlichen Bereichen entwerfen, positionieren Sie diese in einem angenehmen Abstand zum Nutzer, damit er sich nicht überfordert oder zu nah fühlt.
- Adaptive UI für räumliche Layouts verwenden: Verwenden Sie adaptive UI-Konzepte wie Bereiche und progressive Offenlegung, um Ihr Layout effektiv in mehrere räumliche Bereiche aufzuteilen und die Informationsdarstellung zu optimieren.
- Orbiters für persistente Elemente und Muster verwenden: Reservieren Sie Orbiters für persistente und kontextbezogene UX-Elemente wie Navigation und Steuerelemente. Beschränken Sie die Verwendung von Orbitern, um die Übersichtlichkeit zu wahren und Unordnung zu vermeiden.
- Höhe mit Bedacht einsetzen: Wende die räumliche Höhe auf temporäre Komponenten an, die stationär bleiben und nicht mit dem Inhalt scrollen. Vermeiden Sie es, große Bereiche hervorzuheben, um visuelle Unruhe zu vermeiden und eine ausgewogene visuelle Hierarchie beizubehalten.
Jetpack Compose für XR führt neue Komponenten ein, die XR-Erweiterungen verwalten, sodass Sie das nicht tun müssen. Sie können beispielsweise SpatialPopup und SpatialDialog verwenden, um die entsprechenden 2D-Elemente zu ersetzen. Diese Komponenten werden als typische 2D-UI angezeigt, wenn keine räumliche UI verfügbar ist. Wenn möglich, wird die räumliche UI Ihrer App angezeigt. Die Verwendung ist so einfach wie eine einzeilige Änderung, um das entsprechende 2D-UI-Element zu ersetzen.
Dialogfeld in SpatialDialog umwandeln
// Previous approach Dialog( onDismissRequest = onDismissRequest ) { MyDialogContent() } // New XR differentiated approach SpatialDialog( onDismissRequest = onDismissRequest ) { MyDialogContent() }
Pop-up in SpatialPopup umwandeln
// Previous approach Popup(onDismissRequest = onDismissRequest) { MyPopupContent() } // New XR differentiated approach SpatialPopup(onDismissRequest = onDismissRequest) { MyPopupContent() }
2D-UI-Elemente hervorheben
Wenn Sie die Benutzeroberfläche mit einer detaillierteren Steuerung hervorheben möchten, können Sie mit SpatialElevation jede beliebige zusammensetzbare Funktion in Ihrer App auf eine Ebene über dem räumlichen Bereich auf der Z-Achse heben, die Sie mit SpatialElevationLevel festlegen.
So lässt sich die Aufmerksamkeit der Nutzer wecken, eine bessere Hierarchie schaffen und die Lesbarkeit verbessern, wie im folgenden Beispiel gezeigt.
// Elevate an otherwise 2D Composable (signified here by ComposableThatShouldElevateInXr). SpatialElevation(elevation = SpatialElevationLevel.Level4) { ComposableThatShouldElevateInXr() }
Wichtige Punkte zum Code
- Große Bereiche und Ebenen wie Ansichten am unteren Rand und Seitenansichten sollten nicht räumlich dargestellt oder erhöht werden.
- Erhöhen Sie keine UI-Elemente, die mit dem Inhalt scrollbar sind.
2D-Komponenten zu Orbitern migrieren
Orbiters sind schwebende Elemente, die in der Regel Steuerelemente enthalten, mit denen der Nutzer interagieren kann. Orbiters können an räumlichen Bereichen oder anderen Elementen wie räumlichen Layouts verankert werden. Sie bieten mehr Platz für den Inhalt und ermöglichen Nutzenden schnellen Zugriff auf Funktionen, ohne den Hauptinhalt zu verdecken.

Nicht räumliche Navigationsleiste

Spatialisierte (XR-angepasste) Navigationsleiste
Der folgende Beispielcode zeigt, wie Sie eine 2D-UI-Komponente zu einem Orbiter migrieren können.
// Previous approach NavigationRail() // New XR differentiated approach Orbiter( position = OrbiterPosition.TopStart( horizontalEdgeAlignment = OrbiterPosition.EdgeAlignment.Outside, offset = DpVolumeOffset(x = dimensionResource(R.dimen.start_orbiter_padding)) ) ) { NavigationRail() }
Wichtige Informationen zu Orbitern
- Orbiters sind Komponenten, mit denen vorhandene UI-Elemente an einem räumlichen Bereich angebracht werden können.
- In unserem Leitfaden zum Design von Android XR-Apps erfährst du, welche Elemente für Orbiter migriert werden müssen und welche Muster du vermeiden solltest.
- Wir empfehlen, nur wenige Navigationskomponenten wie die Navigationsleiste, die obere App-Leiste oder die untere App-Leiste anzupassen.
- Orbiters werden nicht angezeigt, wenn die räumliche Benutzeroberfläche nicht aktiviert ist. Sie werden beispielsweise nicht im Home Space oder auf Geräten wie Smartphones, Tablets und faltbaren Geräten angezeigt.
2D-Komponenten in räumliche Bereiche migrieren
Räumliche Panels sind die grundlegenden Bausteine der Benutzeroberfläche von Android XR-Apps.
Bereiche dienen als Container für UI-Elemente, interaktive Komponenten und immersive Inhalte. Beim Design können Sie Komponenten wie Orbiters für Nutzersteuerelemente hinzufügen und UI-Elemente räumlich hervorheben, um die Aufmerksamkeit auf bestimmte Interaktionen zu lenken.
Wichtige Punkte zum Code
- In den Designrichtlinien für Android XR-Apps finden Sie Informationen dazu, welche Elemente in Bereiche migriert werden sollten und welche Muster Sie vermeiden sollten.
- Beachten Sie die Best Practices für die Platzierung von räumlichen Bereichen:
- Die Panels sollten in der Mitte, 1,5 m von den Augen des Nutzers entfernt, angezeigt werden.
- Inhalte sollten in den mittleren 41° des Sichtfelds des Nutzers angezeigt werden.
- Die Bereiche bleiben an Ort und Stelle, wenn sich ein Nutzer bewegt. Die Verankerung ist nur für Passthrough verfügbar.
- Verwenden Sie die vom System empfohlenen abgerundeten Ecken mit 32 dp für Bereiche.
- Berührungszielbereiche sollten 56 dp und nicht kleiner als 48 dp sein.
- Achten Sie auf Kontrastverhältnisse, die die Lesbarkeit verbessern, insbesondere wenn Sie transparente Hintergründe verwenden.
- Folge den Android-Designprinzipien für Farben und verwende das Material Design-Farbsystem, um dunkle und helle Designs für deine App zu implementieren.
- Verwenden Sie die Spatial Panels API mit vorhandenen UI-Elementen.
2D-Benutzeroberfläche in einen einzelnen räumlichen Bereich migrieren
Standardmäßig wird Ihre App im Home Space mit einem einzelnen Bereich angezeigt. Informationen zum Wechseln zwischen Home Space und Full Space Wenn Sie diese Inhalte in den Full Space verschieben möchten, können Sie SpatialPanel verwenden.
Hier ist ein Beispiel dafür, wie Sie das tun könnten.
if (LocalSpatialCapabilities.current.isSpatialUiEnabled) { Subspace { SpatialPanel( modifier = SubspaceModifier.movable().resizable(), ) { AppContent() } } } else { AppContent() }
2D-UI zu mehreren räumlichen Bereichen migrieren
Sie können entweder ein einzelnes räumliches Steuerfeld für die Benutzeroberfläche Ihrer App verwenden oder Ihre 2D-Benutzeroberfläche zu mehreren räumlichen Steuerfeldern migrieren. Wenn Sie mehrere Bereiche für die Benutzeroberfläche Ihrer App verwenden möchten, können Sie diese positionieren und drehen (analog zum Layout der Benutzeroberfläche in 2D). Sie beginnen mit einer klaren Designvision für das, was Sie erreichen möchten. Anschließend können Sie die Spatial UI Layout APIs (SpatialBox, SpatialRow, SpatialColumn, SpatialSpacer, SpatialAlignment) und Subspace-Modifikatoren verwenden, um Panels zu positionieren und zu drehen.
Es gibt einige wichtige Muster, die Sie bei der Implementierung mehrerer Bereiche vermeiden sollten.
- Vermeiden Sie überlappende Bereiche, die den Nutzer daran hindern, wichtige Informationen zu sehen.
- Überfordern Sie den Nutzer nicht mit zu vielen Bereichen.
- Vermeide es, Panels an unpraktischen oder unauffälligen Stellen zu platzieren. Beispiel: Bedienfelder, die sich hinter dem Nutzer befinden, sind schwer zu erkennen.
- Weitere Informationen zur Entwicklung einer räumlichen Benutzeroberfläche finden Sie in unserem Leitfaden.

Nicht räumliche Inhalte

Verräumlichte (XR-angepasste) Mediensteuerung in einem Orbiter und in mehrere räumliche Bereiche aufgeteilte Inhalte
SpatialRow { SpatialPanel( SubspaceModifier .width(384.dp) .height(592.dp) ) { StartSupportingPanelContent() } SpatialPanel( SubspaceModifier .height(824.dp) .width(1400.dp) ) { App() } SpatialPanel( SubspaceModifier .width(288.dp) .height(480.dp) ) { EndSupportingPanelContent() } }
Räumliche Funktionen hinzufügen
Nachdem Sie Ihre 2D-UI-Komponenten konzipiert und mit der Konvertierung in 3D begonnen haben, können Sie sich auch andere räumliche Funktionen ansehen, die Sie Ihrer App hinzufügen können, um ein differenzierteres Erlebnis für Android XR zu schaffen.
Räumliche Funktionen prüfen
Wenn du entscheiden möchtest, ob ein bestimmtes UI-Element angezeigt werden soll, solltest du nicht nach bestimmten XR-Geräten oder ‑Modi suchen. Wenn du nach Geräten oder Modi statt nach Funktionen suchst, kann das zu Problemen führen, wenn sich die Funktionen eines bestimmten Geräts im Laufe der Zeit ändern. Verwende stattdessen LocalSpatialCapabilities.current.isSpatialUiEnabled, um direkt nach den erforderlichen Spatial Audio-Funktionen zu suchen, wie im folgenden Beispiel gezeigt.
So wird sichergestellt, dass sich Ihre App korrekt an eine Vielzahl von XR-Umgebungen anpasst, ohne dass jedes Mal Updates erforderlich sind, wenn neue Geräte auf den Markt kommen oder sich die Funktionen ändern.
if (LocalSpatialCapabilities.current.isSpatialUiEnabled) { SupportingInfoPanel() } else { ButtonToPresentInfoModal() } // Similar check for audio val spatialAudioEnabled = LocalSpatialCapabilities.current.isSpatialAudioEnabled
Umgebungen verwenden, um die Umgebung des Nutzers zu ändern
Wenn Sie in Ihrer App ein Gefühl der Immersion erzeugen möchten, indem Sie die Umgebung des Nutzers ändern, können Sie dazu Umgebungen verwenden. Das Hinzufügen einer Umgebung im Code ist eine einfache Änderung, die Sie vornehmen können, ohne die vorhandene Benutzeroberfläche Ihrer App wesentlich zu beeinträchtigen. Weitere Informationen zum Festlegen von Umgebungen finden Sie in unserem vollständigen Leitfaden.
3D-Inhalte hinzufügen
3D-Inhalte wie 3D-Modelle und räumliche Videos können dazu beitragen, ein immersiveres Erlebnis zu schaffen und das räumliche Verständnis zu verbessern. Ihre App kann nur dann 3D-Inhalte anzeigen, wenn räumliche Funktionen verfügbar sind. Sie sollten daher zuerst prüfen, ob räumliche Funktionen verfügbar sind.
Informationen zum Hinzufügen von 3D-Modellen, Spatial Video oder Spatial Audio finden Sie im entsprechenden Leitfaden.