کاربر می‌تواند برنامه شما را در دو حالت تجربه کند: «فضای خانه» یا «فضای کامل». در «فضای صفحه اصلی»، کاربر می‌تواند با اجرای برنامه شما در کنار برنامه‌های دیگر، چندوظیفگی انجام دهد. در «فضای کامل»، برنامه شما به‌عنوان مرکز تجربه کاربر با دسترسی کامل به قابلیت‌های فراگیر Android XR در جایگاه اصلی قرار می‌گیرد.
برنامه شما به‌طور پیش‌فرض در «فضای خانه» باز می‌شود، مگراینکه همان‌طور که در بخش اعلام حالت پیش‌فرض برای راه‌اندازی توضیح داده شده است، خلاف آن را مشخص کنید.
فضاسازی فقط در «فضای کامل» پشتیبانی می‌شود. برنامه شما می‌تواند به فضای کامل منتقل شود تا از قابلیت‌های فضایی و سه‌بعدی بهره‌مند شود. وقتی برنامه شما کانون دارد، می‌توانید با درخواست فضای متناظر بین این حالت‌ها جابه‌جا شوید.
برای جابه‌جایی بین «فضای خانه» و «فضای کامل» از SpaceToggleButton استفاده کنید
برای انتقال بین «فضای صفحه اصلی» و «فضای کامل»، از عنصر
SpaceToggleButton ترکیب‌شدنی در کتابخانه طراحی Material برای واقعیت گسترده
استفاده کنید.
این دکمه‌ای ترکیبی است که با حالت فضایی فعلی تطبیق پیدا می‌کند و بین «فضای کامل» و «فضای خانه» جابه‌جا می‌شود.
ساختن انتقال سفارشی بین «فضای خانه» و «فضای کامل»
اگر از کتابخانه Jetpack Compose برای XR استفاده می‌کنید، بااستفاده از ترکیب محلی LocalSession، فضای خانه یا فضای کامل درخواست کنید.
val session = LocalSession.current ?: return session.scene.requestHomeSpace() // or session.scene.requestFullSpace()
اگر از کتابخانه Jetpack SceneCore استفاده می‌کنید، می‌توانید فضای مربوطه را از Session درخواست کنید؛ دسترسی به جلسه از Jetpack SceneCore را ببینید.
xrSession.scene.requestHomeSpace()
برای نمونه‌هایی از نحوه استفاده از این درخواست‌ها برای انتقال بین حالت‌ها با کلیک کردن روی دکمه، به codelab آشنایی با اصول Android XR: بخش ۱ - حالت‌ها و پانل‌های فضایی مراجعه کنید. همچنین توصیه می‌کنیم راهنمای طراحی ما را مرور کنید تا درباره «فضای خانه» به «فضای کامل» و نحوه بهترین انتقال بین این دو بیشتر بدانید.
حالت پیش‌فرض را برای راه‌اندازی اعلام کنید
یا می‌توانید خطوط زیر را به فایل «مانیفست 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" />