ユーザーは、ホームスペース モードとフルスペース モードの 2 つのモードでアプリを利用できます。ホームスペースでは、アプリを他のアプリと並べて実行して、マルチタスクを行うことができます。フルスペースでは、アプリがユーザー エクスペリエンスの中心となり、Android XR の没入型機能をフルに活用できます。
起動のデフォルト モードを宣言するセクションで説明したように、特に指定しない限り、アプリはデフォルトでホームスペースで開きます。
空間音響はフルスペースでのみサポートされています。アプリはフルスペースに移行して、空間機能と 3D 機能を活用できます。アプリにフォーカスがある場合は、対応するスペースをリクエストすることで、これらのモードを切り替えることができます。
SpaceToggleButton を使用してホームスペースとフルスペースを切り替える
ホームスペースとフルスペースを切り替えるには、XR 用マテリアル デザイン ライブラリの SpaceToggleButton コンポーザブルを使用します。
これは、現在の空間モードに適応し、フルスペースとホームスペースを切り替えることができるコンポーザブル ボタンです。
ホームスペースとフルスペース間のカスタム トランジションを構築する
Jetpack Compose for XR ライブラリを使用している場合は、LocalSpatialConfiguration コンポジション ローカルを使用してホーム スペースまたはフルスペースをリクエストします。
LocalSpatialConfiguration.current.requestHomeSpaceMode() // or LocalSpatialConfiguration.current.requestFullSpaceMode()
Jetpack SceneCore ライブラリを使用している場合は、Session から対応するスペースをリクエストできます。Jetpack SceneCore からセッションにアクセスするをご覧ください。
xrSession.scene.requestHomeSpaceMode()
これらのリクエストを使用してボタンをクリックしてモードを切り替える方法の例については、Android XR の基礎を学ぶ: パート 1 - モードと空間パネルの Codelab をご覧ください。また、ホームスペースからフルスペースへの移行や、両者間の最適な移行方法について詳しくは、設計ガイダンスをご覧ください。
起動のデフォルト モードを宣言する
または、Android マニフェスト ファイルに次の行を追加して、アプリを開くスペースを選択することもできます。
<!-- Launch in Full Space. -->
<property
android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED" />
<!-- Or, launch in Home Space. -->
<property
android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
android:value="XR_ACTIVITY_START_MODE_HOME_SPACE" />