Material Design für Ihre räumliche Benutzeroberfläche implementieren

XR‑Geräte, für die der Leitfaden gilt
Dieser Leitfaden hilft Ihnen dabei, Erlebnisse für die folgenden Arten von XR-Geräten zu entwickeln.
XR-Headsets
Kabelgebundene XR-Datenbrille

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.

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

Nicht räumliche Navigationsleiste

Räumliche (XR-angepasste) Navigationsleiste

Spatialisierte (XR-angepasste) 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

Nicht räumliche Navigationsleiste

Spatialisierte (XR-angepasste) 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

Nicht räumlicher Dialog

Spatial-XR-Dialogfeld

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

Nicht räumliche obere App-Leiste

Spatialisierte (XR-angepasste) 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

Nicht räumliches ListDetailPaneScaffold

Spatialisiertes (XR-angepasstes) 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

Nicht räumliches SupportingPaneScaffold

SupportingPaneScaffold mit räumlicher Darstellung (für XR angepasst)

Räumliches (XR-angepasstes) SupportingPaneScaffold

Mit dem Material 3 Design Kit für Figma Designs erstellen

Collage von Elementen aus dem Material 3 Design Kit

Material 3 Design Kit herunterladen

Weitere Informationen