الانتقال من "المساحة المنزلية" إلى "المساحة الكاملة"
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكن للمستخدم تجربة تطبيقك في وضعَين، هما "مساحة المنزل" أو "المساحة الكاملة". في "مساحة المنزل"، يمكن للمستخدم تنفيذ عدة مهام في الوقت نفسه من خلال تشغيل تطبيقك جنبًا إلى جنب مع تطبيقات أخرى. في وضع "المساحة الكاملة"، يتصدّر تطبيقك المشهد باعتباره محور تجربة المستخدم، مع إمكانية الوصول الكامل إلى إمكانات Android XR الغامرة.
يتم فتح تطبيقك في "مساحة الأطفال" تلقائيًا ما لم تحدّد خلاف ذلك كما هو موضّح في قسم تحديد الوضع التلقائي للتشغيل.
لا تتوفّر ميزة التجسيم إلا في "المساحة الكاملة". يمكن لتطبيقك الانتقال إلى وضع "المساحة الكاملة" للاستفادة من إمكانات العرض المكاني والثلاثي الأبعاد. عندما يكون تطبيقك في وضع التركيز، يمكنك التبديل بين هذين الوضعين من خلال طلب المساحة المناسبة.
الانتقال بين "المساحة المنزلية" و"المساحة الكاملة"
إذا كنت تستخدم مكتبة Jetpack Compose للواقع الممتد، اطلب مساحة منزلية أو مساحة كاملة باستخدام LocalSpatialConfiguration التركيبة المحلية.
راجِع الدرس التطبيقي حول الترميز التعرّف على أساسيات Android XR: الجزء 1 - الأوضاع واللوحات المكانية للاطّلاع على أمثلة حول كيفية استخدام هذه الطلبات للانتقال بين الأوضاع من خلال النقر على زر. ننصحك أيضًا بمراجعة إرشادات التصميم للتعرّف على المزيد حول الانتقال من "المساحة الرئيسية" إلى "المساحة الكاملة" وأفضل طريقة للانتقال بينهما.
تحديد الوضع التلقائي للتشغيل
بدلاً من ذلك، يمكنك إضافة الأسطر التالية إلى ملف AndroidManifest.xml لاختيار المساحة التي يجب أن يفتح فيها تطبيقك:
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-08-23 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-23 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Transition from Home Space to Full Space\n\nA 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--------------------------------------------\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/dd30aee903e8c247786c064faab1a9ca8d10b46e/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/dd30aee903e8c247786c064faab1a9ca8d10b46e/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-----------------------------------\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\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)"]]
