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