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

ユーザーは、ホームスペース モードとフルスペース モードの 2 つのモードでアプリを使用できます。ホームスペースでは、ユーザーは他のアプリと並行してアプリを実行してマルチタスクを行うことができます。フルスペースでは、Android XR のイマーシブ機能に完全にアクセスできるため、ユーザー エクスペリエンスの中心としてアプリが際立ちます。

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

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

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

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

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

Jetpack SceneCore ライブラリを使用している場合は、Session から対応するスペースをリクエストできます。

val xrSession = Session.create(this)
xrSession.spatialEnvironment.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_MANAGED" />

関連ドキュメント