空間化されたコンポーネント

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

Jetpack Compose for XR には、アプリの空間 UI とレイアウトを構築するのに役立つさまざまな空間化コンポーネントが含まれています。

サブスペース コンポーザブル

サブスペース コンポーザブルは、サブスペースでのみレンダリングできる特別なタイプの空間化コンポーネントです。2D レイアウト内に配置する前に、Subspace で囲む必要があります。SubspaceModifier を使用すると、奥行き、オフセット、配置などの属性をサブスペース コンポーザブルに追加できます。

その他の空間化されたコンポーネント

他の空間化コンポーネントは、サブスペース内で呼び出す必要はありません。これらは、空間コンテナ内にラップされた従来の 2D 要素で構成されています。これらの要素は、2D と 3D の両方で定義されている場合、2D または 3D のレイアウト内で使用できます。空間化が有効になっていない場合、空間化された機能は無視され、2D の対応する機能にフォールバックされます。

空間化されたコンポーネントは、アプリの UI 階層のどこにでも配置できます。これらの要素は 2D UI で再利用できます。空間属性は、空間機能が有効になっている場合にのみ表示されます。これにより、コードを 2 回記述することなく、メニュー、ダイアログ、その他のコンポーネントにエレベーションを追加できます。空間化が有効になっている場合と有効になっていない場合で、空間化されたさまざまなコンポーネントの動作がどのように変化するかを、以下にいくつか例を示します。

空間化コンポーネント

空間化が有効になっている場合

2D 環境の場合

SpatialDialog

パネルが Z 深度で少し後ろに押し込まれ、上部にダイアログが表示される

2D Dialog にフォールバックします。

SpatialPopup

パネルが Z 深度で少し押し戻され、ポップアップが前面に表示される

2D Popup にフォールバックします。

SpatialElevation

SpatialElevationLevel を設定して、エレベーションを追加できます。

空間的な高低差がないことを示します。

ガイド

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