サブスペースで 3D 空間を配置する

対象となる XR デバイス
このガイダンスは、次のようなタイプの XR デバイス向けのエクスペリエンスを構築する際に役立ちます。
XR ヘッドセット
有線 XR グラス

サブスペースは、アプリ内の 3D 空間を区切ったパーティションです。これにより、3D コンテンツの配置、3D レイアウトの構築、2D コンテンツへの奥行き追加ができるようになります。サブスペースは、空間化が有効になっている場合にのみレンダリングされます。ホームスペースまたは XR 以外のデバイスでは、サブスペース内のコードは無視されます。

サブスペースを作成するには、複数の方法があります。

  • Subspace を使用する: このコンポーズ可能な関数は、新しい独立した空間 UI 階層を作成します。ネストされている親 Subspace の空間位置、向き、スケールは継承されません。Subspace は、システムの推奨コンテンツ ボックスによって自動的にバインドされます。このコンポーザブルを使用すると、固定位置に留まる標準のサブスペースを作成するか、ターゲットに追従するサブスペースを作成するかを選択できます。
  • PlanarEmbeddedSubspace を使用する: このコンポーズ可能関数は、アプリの UI 階層内に配置できるため、2D UI と空間 UI のレイアウトを維持できます。PlanarEmbeddedSubspace は、親の制約と配置を尊重します。その中に配置された 3D コンテンツは、この 2D 定義領域を基準に配置されます。

ガイド

このセクションには、次のデベロッパー ガイドが含まれています。