3D-Space mit untergeordneten Spaces einrichten

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

Ein Subspace ist eine Partition des 3D-Raums in Ihrer App, in der Sie 3D-Inhalte platzieren, 3D-Layouts erstellen und 2D-Inhalten Tiefe verleihen können. Ein Unterraum wird nur gerendert, wenn die Spatialisierung aktiviert ist. Im Home Space oder auf Nicht-XR-Geräten wird jeglicher Code innerhalb eines Subspace ignoriert.

Es gibt mehrere Möglichkeiten, einen Unterbereich zu erstellen:

  • Subspace verwenden: Mit dieser komponierbaren Funktion wird eine neue, unabhängige räumliche UI-Hierarchie erstellt. Sie übernimmt nicht die räumliche Position, Ausrichtung oder Skalierung eines übergeordneten Subspace, in dem sie verschachtelt ist. Ein Subspace wird automatisch durch die vom System empfohlene Content-Box begrenzt. Mit diesem Composable können Sie entweder einen Standard-Subspace erstellen, der an einer festen Position bleibt, oder einen Subspace, der einem Ziel folgt.
  • PlanarEmbeddedSubspace verwenden: Dieses Compose-Element kann in der UI-Hierarchie Ihrer App platziert werden, sodass Sie Layouts für 2D- und räumliche Benutzeroberflächen verwalten können. PlanarEmbeddedSubspace berücksichtigt die Einschränkungen und die Positionierung des übergeordneten Elements. Die darin platzierten 3D-Inhalte werden dann relativ zu diesem 2D-definierten Bereich positioniert.

Leitfäden

Dieser Abschnitt enthält die folgenden Entwicklerleitfäden: