کاربر میتواند برنامه شما را در دو حالت Home Space یا Full Space تجربه کند. در Home Space، کاربر قادر است همزمان با اجرای برنامه شما در کنار سایر برنامهها، به انجام چند کار همزمان بپردازد. در Full Space، برنامه شما با دسترسی کامل به قابلیتهای فراگیر اندروید XR، در مرکز توجه تجربه کاربر قرار میگیرد.
برنامه شما به طور پیشفرض در فضای خانه باز میشود، مگر اینکه طبق توضیحات بخش «اعلام حالت پیشفرض برای اجرا»، طور دیگری تعیین کنید.
فضاسازی فقط در حالت Full Space پشتیبانی میشود. برنامه شما میتواند برای استفاده از قابلیتهای فضایی و سهبعدی به حالت Full Space منتقل شود. وقتی برنامه شما فوکوس دارد، میتوانید با درخواست فضای مربوطه، بین این حالتها جابجا شوید.
برای تغییر بین فضای خانه و فضای کامل SpaceToggleButton استفاده کنید.
برای جابجایی بین Home Space و Full Space از SpaceToggleButton قابل ترکیب از کتابخانه Material Design for XR استفاده کنید.
این یک دکمهی ترکیبی است که با حالت مکانی فعلی سازگار میشود و بین حالتهای Full Space و Home Space تغییر حالت میدهد.
یک انتقال سفارشی بین فضای خانه و فضای کامل ایجاد کنید
اگر از کتابخانه Jetpack Compose for XR استفاده میکنید، با استفاده از ترکیب LocalSpatialConfiguration به صورت محلی، فضای خانه یا فضای کامل را درخواست کنید.
LocalSpatialConfiguration.current.requestHomeSpaceMode() // or LocalSpatialConfiguration.current.requestFullSpaceMode()
اگر از کتابخانه Jetpack SceneCore استفاده میکنید، میتوانید فضای مربوطه را از Session درخواست کنید؛ به بخش دسترسی به Session از Jetpack SceneCore مراجعه کنید.
xrSession.scene.requestHomeSpaceMode()
برای مثالهایی از نحوه استفاده از این درخواستها برای انتقال بین حالتها با کلیک روی یک دکمه، به بخش «آموزش اصول اولیه اندروید XR: قسمت 1 - حالتها و پنلهای فضایی» در codelab مراجعه کنید. همچنین توصیه میکنیم برای کسب اطلاعات بیشتر در مورد «فضای خانه» به «فضای کامل» و نحوه انتقال بهینه بین این دو، راهنمای طراحی ما را مرور کنید.
حالت پیشفرض را برای راهاندازی اعلام کنید
به عنوان یک روش جایگزین، میتوانید خطوط زیر را به فایل Manifest اندروید خود اضافه کنید تا انتخاب کنید برنامه شما در کدام فضا باز شود:
<!-- 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" />
همچنین ببینید
- بررسی قابلیتهای مکانی
- ایجاد یک جلسه
- محیطها را به برنامه خود اضافه کنید
- مدلهای سهبعدی را به برنامه خود اضافه کنید