انتقال از فضای خانه به فضای کامل

کاربر می تواند برنامه شما را در دو حالت Home Space یا Full Space تجربه کند. در Home Space، کاربر می‌تواند با برنامه شما که در کنار سایر برنامه‌ها اجرا می‌شود، چند کار انجام دهد. در فضای کامل، برنامه شما در مرکز توجه تجربه کاربر با دسترسی کامل به قابلیت‌های فراگیر Android XR قرار می‌گیرد.

برنامه شما به طور پیش‌فرض در Home Space باز می‌شود، مگر اینکه چیز دیگری را همانطور که در بخش اعلام حالت پیش‌فرض برای راه‌اندازی توضیح داده شده است، مشخص کنید.

Spatialization فقط در Full Space پشتیبانی می شود. برنامه شما می‌تواند به فضای کامل منتقل شود تا از قابلیت‌های فضایی و سه بعدی استفاده کند. وقتی برنامه شما فوکوس دارد، می‌توانید با درخواست فضای مربوطه، بین این حالت‌ها جابه‌جا شوید.

انتقال بین فضای خانه و فضای کامل

اگر از کتابخانه Jetpack Compose برای XR استفاده می کنید، با استفاده از LocalSpatialConfiguration ترکیب محلی، فضای خانه یا فضای کامل را درخواست کنید.

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

اگر از کتابخانه Jetpack SceneCore استفاده می کنید، می توانید فضای مربوطه را از Session درخواست کنید.

val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()

برای مثال‌هایی از نحوه استفاده از این درخواست‌ها برای انتقال بین حالت‌ها با کلیک کردن بر روی یک دکمه، به آموزش اصول Android XR: قسمت 1 - کد حالت‌ها و پانل‌های فضایی مراجعه کنید. همچنین توصیه می‌کنیم راهنمای طراحی خود را مرور کنید تا درباره فضای خانه به فضای کامل و نحوه بهترین انتقال بین این دو بیشتر بدانید.

حالت پیش فرض را برای راه اندازی اعلام کنید

همچنین، می‌توانید خطوط زیر را به فایل Manifest 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" />

همچنین ببینید

،

کاربر می تواند برنامه شما را در دو حالت Home Space یا Full Space تجربه کند. در Home Space، کاربر می‌تواند با برنامه شما که در کنار سایر برنامه‌ها اجرا می‌شود، چند کار انجام دهد. در فضای کامل، برنامه شما در مرکز توجه تجربه کاربر با دسترسی کامل به قابلیت‌های فراگیر Android XR قرار می‌گیرد.

برنامه شما به طور پیش‌فرض در Home Space باز می‌شود، مگر اینکه چیز دیگری را همانطور که در بخش اعلام حالت پیش‌فرض برای راه‌اندازی توضیح داده شده است، مشخص کنید.

Spatialization فقط در Full Space پشتیبانی می شود. برنامه شما می‌تواند به فضای کامل منتقل شود تا از قابلیت‌های فضایی و سه بعدی استفاده کند. وقتی برنامه شما فوکوس دارد، می‌توانید با درخواست فضای مربوطه، بین این حالت‌ها جابه‌جا شوید.

انتقال بین فضای خانه و فضای کامل

اگر از کتابخانه Jetpack Compose برای XR استفاده می کنید، با استفاده از LocalSpatialConfiguration ترکیب محلی، فضای خانه یا فضای کامل را درخواست کنید.

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

اگر از کتابخانه Jetpack SceneCore استفاده می کنید، می توانید فضای مربوطه را از Session درخواست کنید.

val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()

برای مثال‌هایی از نحوه استفاده از این درخواست‌ها برای انتقال بین حالت‌ها با کلیک کردن بر روی یک دکمه، به آموزش اصول Android XR: قسمت 1 - کد حالت‌ها و پانل‌های فضایی مراجعه کنید. همچنین توصیه می‌کنیم راهنمای طراحی خود را مرور کنید تا درباره فضای خانه به فضای کامل و نحوه بهترین انتقال بین این دو بیشتر بدانید.

حالت پیش فرض را برای راه اندازی اعلام کنید

همچنین، می‌توانید خطوط زیر را به فایل Manifest 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" />

همچنین ببینید