Material Design bietet Komponenten und Layouts für XR. Mit der Material 3-Bibliothek, adaptiven Layouts und der XR Compose Material 3-Bibliothek können Sie räumliche UI-Verhaltensweisen in Ihre Compose-App einbinden.
Fügen Sie die XR Compose Material 3-Bibliothek zu den Abhängigkeiten Ihrer App hinzu, um Material 3 für XR-Komponenten zu verwenden, oder platzieren Sie standardmäßige Material 3-Komponenten direkt in Jetpack Compose für XR-Container wie Orbiter, SpatialDialog und SpatialPanel.
Material 3 für XR-Komponenten verwenden
Die androidx.xr.compose.material3-Bibliothek bietet Material 3 für XR-Komponenten für gängige räumliche UI-Muster, darunter Navigationsleisten, obere App-Leisten, schwebende Symbolleisten, Dialogfelder, Listen-Detailansichten und einen Ein/Aus-Button zum Wechseln zwischen Home Space und Full Space. Die räumlichen Spatial*-Kompositionen in dieser Bibliothek sind experimentell und erfordern die Aktivierung mit @OptIn(ExperimentalMaterial3XrApi::class).
Prüfen Sie LocalSpatialCapabilities.current.isSpatialUiEnabled, um Material 3 für XR-Komponenten zu rendern, wenn die räumliche UI aktiviert ist, und Standardkomponenten von Material 3, wenn die räumliche UI nicht aktiviert ist. Weitere Informationen finden Sie unter Räumliche Funktionen prüfen.
Navigationsstreifen
Verwenden Sie SpatialNavigationRail oder SpatialWideNavigationRail, um eine Material 3-Navigationsleiste in einem am Anfang ausgerichteten Orbiter anzuzeigen, wenn die räumliche Benutzeroberfläche aktiviert ist. Weitere Informationen finden Sie in den Material Design-Richtlinien.

Nicht räumliche Navigationsleiste

Spatialisierte (XR-angepasste) Navigationsleiste
Navigationsleiste
Verwenden Sie SpatialNavigationBar oder SpatialShortNavigationBar, um eine Material 3-Navigationsleiste in einer unten ausgerichteten Orbiter anzuzeigen, wenn die räumliche UI aktiviert ist. Weitere Informationen finden Sie in den Material Design-Richtlinien.

Nicht räumliche Navigationsleiste

Spatialisierte (XR-angepasste) Navigationsleiste
Dialogfelder
Verwenden Sie SpatialBasicAlertDialog, um ein einfaches Benachrichtigungsdialogfeld in einem SpatialDialog mit räumlicher Erhöhung anzuzeigen, oder verpacken Sie Standard-Material 3-Dialogfeldinhalte direkt in SpatialDialog.
Weitere Informationen finden Sie unter Dialogfelder und in den Richtlinien für adaptives Design.

Nicht räumlicher Dialog

Spatial-Audio-Dialog (für XR angepasst)
Obere App-Leisten
Verwenden Sie SpatialTopAppBar oder SpatialTwoRowsTopAppBar, um eine obere App-Leiste von Material 3 in einer oben ausgerichteten Orbiter anzuzeigen, wenn die räumliche UI aktiviert ist.
Weitere Informationen finden Sie unter Obere App-Leisten und in den Richtlinien für adaptives Design.

Nicht räumliche obere App-Leiste

Räumliche (für XR angepasste) obere App-Leiste
Listen-Detailansicht-Layout für XR
Verwenden Sie SpatialListDetailPaneScaffold, wenn die räumliche Benutzeroberfläche aktiviert ist, um ein adaptives Material 3-Listen-Detailansicht-Layout anzuzeigen, bei dem jeder Bereich in einem eigenen SpatialPanel platziert ist. Wenn die räumliche Benutzeroberfläche nicht aktiviert ist, verwenden Sie ListDetailPaneScaffold. Weitere Informationen finden Sie unter Listen-Detail-Layout und in den Richtlinien für adaptives Design.

Nicht räumliches ListDetailPaneScaffold

Spatialisiertes (XR-angepasstes) ListDetailPaneScaffold
Unterstützung für den Bereich „Layout“ für XR
Wenn die räumliche Benutzeroberfläche aktiviert ist, platzieren Sie den Haupt- und den Nebenbereich in separaten SpatialPanel-Containern innerhalb eines SpatialRow in einem Subspace. Wenn die räumliche Benutzeroberfläche nicht aktiviert ist, verwenden Sie SupportingPaneScaffold. Weitere Informationen finden Sie unter Unterstützender Bereich und in den Richtlinien für adaptives Design.

Nicht räumliches SupportingPaneScaffold

Räumliches (XR-angepasstes) SupportingPaneScaffold
Mit dem Material 3 Design Kit für Figma Designs erstellen

Material 3 Design Kit herunterladen
Weitere Informationen
- Benutzeroberfläche mit Jetpack Compose für XR entwickeln
- Vom Home Space zum Full Space wechseln
- Richtlinien für das Design räumlicher Benutzeroberflächen