ホームスペースからフルスペースへの移行

ユーザーは、ホームスペース モードまたはフルスペース モードの 2 つのモードでアプリを利用できます。ホームスペースでは、アプリを他のアプリと並べて実行して、マルチタスクを行うことができます。フルスペースでは、アプリがユーザー エクスペリエンスの中心となり、Android XR の没入型機能をフルに活用できます。

起動のデフォルト モードを宣言するセクションで説明したように、特に指定しない限り、アプリはデフォルトでホームスペースで開きます。

空間化はフルスペースでのみサポートされています。アプリは、空間機能と 3D 機能を活用するためにフルスペースに移行できます。アプリにフォーカスがある場合は、対応するスペースをリクエストすることで、これらのモードを切り替えることができます。

ホームスペースとフルスペースの切り替え

Jetpack Compose for XR ライブラリを使用している場合は、LocalSpatialConfiguration コンポジション ローカルを使用してホーム スペースまたはフルスペースをリクエストします。

LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()
ModeTransition.kt

Jetpack SceneCore ライブラリを使用している場合は、Session から対応するスペースをリクエストできます。Jetpack SceneCore からセッションにアクセスするをご覧ください。

xrSession.scene.requestHomeSpaceMode()
ModeTransition.kt

これらのリクエストを使用してボタンをクリックしてモードを切り替える方法の例については、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_MANAGED" />

関連ドキュメント