没入型 XR のデザイン: レイアウト
没入型拡張現実(XR)デバイス向けのリソースとガイダンス
XR では、レイアウトは画面の枠を超えて現実世界に広がります。空間パネル、3D モデル、没入型環境は、無限のキャンバス上に自由に配置できます。
画面端に制約されるモバイルレイアウトとは異なり、XR レイアウトでは次の要素を考慮する必要があります:
- Z 軸方向の奥行き
- ユーザーとの距離
- ユーザーの視野
XR レイアウトの基本
Android XR アプリの基本的な構成要素は空間パネルです。パネルは UI 要素のコンテナとして機能し、オービター、3D モデル、環境とともに空間内に配置できます。
TIP
空間パネルはフルスペースでのみ使用できます。ホームスペースでは現在使用できません。
空間パネル
フルスペースでは、空間パネルは、UI 要素、メディア、空間ビデオを配置できる柔軟なキャンバスです。
多くの場合、3D モデルやオービターのアンカーとして機能します。
サイズと位置
フルスペースでは、パススルー環境と仮想環境のどちらでもパネルを配置できます。
デフォルトでは、空間パネルは次の設定で表示されます:
- サイズ: 1024×720dp
- ユーザーから 1.75 メートル離れた位置
- コーナー半径 32dp
フルスペースでは、パネルに最小サイズはありません。パネルの最大サイズは 2560×1800dp です。
ユーザーがフルスペースからホームスペースに切り替えても、空間パネルは通常、切り替え前と同じ位置に維持されます。



アダプティブデザイン
空間パネルは、ユーザーからの距離に基づいて動的にスケールします。
Material 3 コンポーネントはアダプティブデザインを採用しており、どの距離や角度でもコンテンツが読みやすく快適に表示されるよう、自動的にスケーリングとリフローを行います。
システム UI との競合を避けるため、パネルはデフォルトの移動制限の範囲内に収めてください:
- 最小奥行き: 0.75 メートル
- 最大奥行き: 5 メートル
パネルのグループ化
フルスペースでは、アプリを複数の空間パネルに分割し、フラット、湾曲、自由配置のいずれかのレイアウトで配置できます。


オービター
オービターは、空間パネルに付随するフローティング要素です。
メインコンテンツを覆い隠さずにナビゲーション UI を常に利用可能にしたい場合は、オービターを使用します。
Material のXR コンポーネントは自動的にオービターに適応します。
空間エレベーションと奥行き
Z 軸を使用して立体的な UI を作成します。影を使用する 2D エレベーションとは異なり、立体的な UI は実際の奥行きを使用します。
- 空間エレベーションは階層を作り、アクティブな要素を前面に表示し、背景の要素を後方に下げることができます
- レイヤーを重ねることで、UI のレイヤーを物理的に分離できます。たとえば、スクリムをダイアログ ボックスの数センチメートル後方に浮かせて表示できます。
動作
アンカリング
パススルーでは、レイアウトを現実世界と連動させることができます:
- ワールドロック: パネルは、テーブルに固定された音楽プレーヤーのように、部屋の特定の場所に留まります
- ヘッドロック: UI をユーザーの頭部の視点に直接固定すると、違和感や不快感につながるため避けてください。代わりに、UI がユーザーの動きにゆるやかに追従する動作(レイジー フォロー)を使用します。
色のコントラストとディミング
標準のサーフェス トークンを使用すると、パネルのコントラストは自動的に調整されます:
- パススルー: 現実の部屋が明るい場合、システムは UI の視認性を確保するために背景を暗くします
- 仮想環境: パネルは仮想世界の照明に合わせて変化します