با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
کاربر می تواند برنامه شما را در دو حالت Home Space یا Full Space تجربه کند. در Home Space، کاربر می‌تواند با برنامه شما که در کنار سایر برنامه‌ها اجرا می‌شود، چند کار انجام دهد. در فضای کامل، برنامه شما در مرکز توجه تجربه کاربر با دسترسی کامل به قابلیت‌های فراگیر Android XR قرار می‌گیرد.
برنامه شما به طور پیش‌فرض در Home Space باز می‌شود، مگر اینکه چیز دیگری را همانطور که در بخش اعلام حالت پیش‌فرض برای راه‌اندازی توضیح داده شده است، مشخص کنید.
Spatialization فقط در Full Space پشتیبانی می شود. برنامه شما می‌تواند به فضای کامل منتقل شود تا از قابلیت‌های فضایی و سه بعدی استفاده کند. وقتی برنامه شما فوکوس دارد، می‌توانید با درخواست فضای مربوطه، بین این حالت‌ها جابه‌جا شوید.
انتقال بین فضای خانه و فضای کامل
اگر از کتابخانه Jetpack Compose برای XR استفاده می کنید، با استفاده از LocalSpatialConfiguration ترکیب محلی، فضای خانه یا فضای کامل را درخواست کنید.
برای مثال‌هایی از نحوه استفاده از این درخواست‌ها برای انتقال بین حالت‌ها با کلیک کردن بر روی یک دکمه، به آموزش اصول Android XR: قسمت 1 - کد حالت‌ها و پانل‌های فضایی مراجعه کنید. همچنین توصیه می‌کنیم راهنمای طراحی خود را مرور کنید تا درباره فضای خانه به فضای کامل و نحوه بهترین انتقال بین این دو بیشتر بدانید.
حالت پیش فرض را برای راه اندازی اعلام کنید
همچنین، می‌توانید خطوط زیر را به فایل Manifest Android خود اضافه کنید تا انتخاب کنید برنامه شما در کدام فضای باز شود:
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-08-30 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-30 بهوقت ساعت هماهنگ جهانی."],[],[],null,["A user can experience your app in two modes, Home Space or Full Space. In Home\nSpace, a user is able to multitask with your app running side by side with other\napps. In Full Space, your app takes center stage as the focus of the user's\nexperience with full access to the immersive capabilities of Android XR.\n\nYour app opens in Home Space by default unless you specify otherwise as\ndescribed in the [Declare the default mode for launch](#declare-default-mode) section.\n\n[Spatialization](/design/ui/xr/guides/foundations) is only supported in Full Space. Your app can transition to\nFull Space to take advantage of spatial and 3D capabilities. When your app has\nfocus, you can transition between these modes by requesting the corresponding\nspace.\n\nTransition between Home Space and Full Space\n\nIf you are using the Jetpack Compose for XR library, request home space or full\nspace using the [`LocalSpatialConfiguration`](/reference/kotlin/androidx/xr/compose/platform/package-summary#LocalSpatialConfiguration()) composition local.\n\n\n```kotlin\nLocalSpatialConfiguration.current.requestHomeSpaceMode()\n// or\nLocalSpatialConfiguration.current.requestFullSpaceMode()https://github.com/android/snippets/blob/f95ab59fad80aeaf5d6a90bab8a01a126f20f44e/xr/src/main/java/com/example/xr/misc/ModeTransition.kt#L27-L29\n```\n\n\u003cbr /\u003e\n\nIf you are using the Jetpack SceneCore library, you can request the\ncorresponding space from the [`Session`](/reference/kotlin/androidx/xr/runtime/Session); see [Access Session from Jetpack\nSceneCore](/develop/xr/jetpack-xr-sdk/add-session#access-session).\n\n\n```kotlin\nxrSession.scene.requestHomeSpaceMode()https://github.com/android/snippets/blob/f95ab59fad80aeaf5d6a90bab8a01a126f20f44e/xr/src/main/java/com/example/xr/misc/ModeTransition.kt#L35-L35\n```\n\n\u003cbr /\u003e\n\nSee the [Learn Android XR Fundamentals: Part 1 - Modes and Spatial Panels](/codelabs/xr-fundamentals-part-1#5)\ncodelab for examples of how to use these requests to transition between modes by\nclicking a button. We also recommend reviewing our [design guidance](/design/ui/xr/guides/foundations) to learn\nmore about Home Space to Full Space and how to best transition between the two.\n\nDeclare the default mode for launch\n\nAlternatively, you can add the following lines to your Android Manifest file to\nchoose which space your app should open in: \n\n \u003c!-- Launch in Full Space. --\u003e\n \u003cproperty\n android:name=\"android.window.PROPERTY_XR_ACTIVITY_START_MODE\"\n android:value=\"XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED\" /\u003e\n\n \u003c!-- Or, launch in Home Space. --\u003e\n \u003cproperty\n android:name=\"android.window.PROPERTY_XR_ACTIVITY_START_MODE\"\n android:value=\"XR_ACTIVITY_START_MODE_HOME_SPACE_MANAGED\" /\u003e\n\n| **Note:** These manifest attributes can be declared at either the `\u003cactivity\u003e` or the `\u003capplication\u003e` level in your app's manifest. Declaring at the activity level will impact the launch preference for the activity element you apply it to.\n\nSee also\n\n- [Check for spatial capabilities](/develop/xr/jetpack-xr-sdk/check-spatial-capabilities)\n- [Create a session](/develop/xr/jetpack-xr-sdk/add-session)\n- [Add environments to your app](/develop/xr/jetpack-xr-sdk/add-environments)\n- [Add 3D models to your app](/develop/xr/jetpack-xr-sdk/add-3d-models)"]]
