Android XR SDK'sı artık Geliştirici Önizlemesi'nde kullanılabilir. Geri bildirimlerinizi bekliyoruz! Bizimle iletişime geçmek için destek sayfamızı ziyaret edin.
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kullanıcılar, uygulamanızı iki modda deneyimleyebilir: Ev Alanı veya Tam Alan. Kullanıcılar, Ev Alanı'nda uygulamanızı diğer uygulamalarla yan yana çalıştırarak çoklu görev yapabilir. Tam alanda, uygulamanız kullanıcının deneyiminin odak noktası olarak ön plana çıkar ve Android XR'ın etkileyici özelliklerine tam erişim sağlar.
Başlatma için varsayılan modu bildirme bölümünde açıklandığı şekilde başka bir mod belirtmediğiniz sürece uygulamanız varsayılan olarak Ev Alanı'nda açılır.
Uzamsallaştırma yalnızca Tam Alan'da desteklenir. Uygulamanız, uzamsal ve 3D özelliklerden yararlanmak için Tam Uzay'a geçiş yapabilir. Uygulamanız odaklandığında, ilgili alanı isteyerek bu modlar arasında geçiş yapabilirsiniz.
Ev alanı ile tam alan arasında geçiş yapma
XR için Jetpack Compose kitaplığını kullanıyorsanız LocalSpatialConfiguration kompozisyon yerelini kullanarak ana alanı veya tam alanı isteyin.
Bir düğmeyi tıklayarak modlar arasında geçiş yapmak için bu isteklerin nasıl kullanılacağına dair örnekler için Android XR'ın Temellerini Öğrenin: Bölüm 1 - Modlar ve Uzamsal Paneller
codelab'ine bakın. Ayrıca, Ev Alanı'ndan Tam Alan'a geçiş ve bu iki alan arasında en iyi şekilde nasıl geçiş yapacağınız hakkında daha fazla bilgi edinmek için tasarım rehberimizi incelemenizi öneririz.
Başlatma için varsayılan modu bildirme
Alternatif olarak, uygulamanızın hangi alanda açılacağını seçmek için Android Manifest dosyanıza aşağıdaki satırları ekleyebilirsiniz:
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-30 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-08-30 UTC."],[],[],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)"]]
