Komponenten mit Spatial Audio

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

Jetpack Compose für XR enthält eine Vielzahl von räumlichen Komponenten, mit denen Sie räumliche Benutzeroberflächen und Layouts für Ihre App erstellen können.

Subspace-Kompositionen

Subspace-Kompositionen sind eine spezielle Art von räumlichen Komponenten, die nur in einem Subspace gerendert werden können und in Subspace eingeschlossen werden müssen, bevor sie in einem 2D-Layout platziert werden. Mit einem SubspaceModifier können Sie Ihren Subspace-Kompositfunktionen Attribute wie Tiefe, Versatz und Positionierung hinzufügen.

Andere räumliche Komponenten

Andere räumliche Komponenten müssen nicht innerhalb eines Unterbereichs aufgerufen werden. Sie bestehen aus herkömmlichen 2D-Elementen, die in einem räumlichen Container verpackt sind. Diese Elemente können in 2D- oder 3D-Layouts verwendet werden, wenn sie für beide definiert sind. Wenn die Spatialization nicht aktiviert ist, werden die räumlichen Funktionen ignoriert und es wird auf die 2D-Entsprechungen zurückgegriffen.

Komponenten mit Spatial Audio können an einer beliebigen Stelle in der UI-Hierarchie Ihrer App platziert werden. Diese Elemente können in Ihrer 2D-UI wiederverwendet werden. Ihre räumlichen Attribute sind nur sichtbar, wenn räumliche Funktionen aktiviert sind. So können Sie Menüs, Dialogfeldern und anderen Komponenten eine Erhöhung hinzufügen, ohne den Code zweimal schreiben zu müssen. Hier sind einige Beispiele dafür, wie sich das Verhalten verschiedener räumlicher Komponenten ändert, wenn die Räumlichkeit aktiviert ist oder nicht:

Spatial Audio-Komponente

Wenn die Verräumlichung aktiviert ist

In 2D-Umgebung

SpatialDialog

Das Steuerfeld wird in der Z-Tiefe leicht nach hinten verschoben, um ein erhöhtes Dialogfeld anzuzeigen.

Wechselt zurück zu 2D-Dialog.

SpatialPopup

Das Steuerfeld wird in der Z-Tiefe leicht nach hinten verschoben, um ein erhöhtes Pop-up anzuzeigen.

Es wird ein Fallback auf ein 2D-Popup durchgeführt.

SpatialElevation

SpatialElevationLevel kann festgelegt werden, um eine Erhöhung hinzuzufügen.

Zeigt keine räumliche Erhöhung.

Leitfäden

Dieser Abschnitt enthält die folgenden Entwicklerleitfäden: