XR için Jetpack Compose
| Son Güncelleme | Kararlı sürüm | Sürüm Adayı | Beta Sürümü | Alfa sürümü |
|---|---|---|---|---|
| 22 Ekim 2025 | - | - | - | 1.0.0-alpha08 |
Bağımlılıkları bildirme
XR Compose'a bağımlılık eklemek için Google Maven deposunu projenize eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu okuyun.
Uygulamanız veya modülünüz için build.gradle dosyasına ihtiyacınız olan yapılarla ilgili bağımlılıkları ekleyin:
Eski
dependencies { implementation "androidx.xr.compose:compose:1.0.0-alpha08" // Use to write unit tests testImplementation "androidx.xr.compose:compose-testing:1.0.0-alpha08" }
Kotlin
dependencies { implementation("androidx.xr.compose:compose:1.0.0-alpha08") // Use to write unit tests testImplementation("androidx.xr.compose:compose-testing:1.0.0-alpha08") }
Bağımlılıklar hakkında daha fazla bilgi için Derleme bağımlılıkları ekleme başlıklı makaleyi inceleyin.
Geri bildirim
Geri bildiriminiz Jetpack'in iyileştirilmesine yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmeye yönelik fikirleriniz varsa lütfen bize bildirin. Yeni bir sorun oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir soruna oyunuzu ekleyebilirsiniz.
Daha fazla bilgi için Sorun İzleyici belgelerini inceleyin.
Sürüm 1.0
Sürüm 1.0.0-alpha08
22 Ekim 2025
androidx.xr.compose:compose:1.0.0-alpha08 ve androidx.xr.compose:compose-testing:1.0.0-alpha08 yayınlandı. 1.0.0-alpha08 sürümü bu commit'leri içerir.
API Değişiklikleri
ResizePolicy,onResizeUpdateveonResizeEnd'ü kabul edecek şekilde değiştirildi.onResizeStart(I7e21f)
Hata Düzeltmeleri
- Bir etkinliği alt alanla yok ederken kilitlenmeyi önleme. (I595a1)
Sürüm 1.0.0-alpha07
24 Eylül 2025
androidx.xr.compose:compose:1.0.0-alpha07 ve androidx.xr.compose:compose-testing:1.0.0-alpha07 yayınlandı. 1.0.0-alpha07 sürümü bu commit'leri içerir.
API Değişiklikleri
SpatialMainPaneliçin geliştirilmiş KDocs. (I27b70, b/444467891)SpatialRowveSpatialColumngibi 3D düzenlerde çocukları ana eksen boyunca düzenlemek içinSpatialArrangementözelliği eklendi. Bu yeni API, 2D Compose'dakiStart,End,Center,SpaceBetween,SpaceAroundveSpaceEvenlygibi düzenleme seçeneklerini sunar. Ayrıca, soldan sağa ve sağdan sola düzen yönleri için tam destek sağlar. (I7db38, b/436289959)SubspaceModifier.Nodeiçin temel bir arayüz eklenerek tür güvenliği ve uzantı arayüzlerinin kullanılabilirliği iyileştirildi. Örneğin:CompositionLocalConsumerSubspaceModifierNodeLayoutCoordinatesAwareModifierNodeSubspaceLayoutModifierNodeCoreEntityNode(şirket içi) (Iede00, b/440599394, b/440599394)
- Kısıtlamayı kaldırma
SpatialExternalSurface(I33315, b/439646773) - Subspace composable'larına
SubspaceModifier'ı ekleyin ve kısıtlamalar parametresiniSubspaceModifierile değiştirip boyutla ilgiliSubspaceModifiersile değiştirin.allowUnboundedSubspacedoğruysa alt alanlarda sınırsız kısıtlamalar olabilir. (Ib06e6, b/433331675) DragPolicy()veResizePolicy(),SpatialPanelveSpatialExternalSurfaceAPI'sinin (I397bf, b/437924639) bir parçası olduğundan artık taşınabilir ve yeniden boyutlandırılabilirSubspaceModifiersdesteği sonlandırılıyor.- Uzamsal düzenlerde
LayoutDirectioniçin destek eklendi.SpatialAlignmentkullanılarak oluşturulan composable'lar artık hem soldan sağa hem de sağdan sola bağlamlarda öğeleri doğru şekilde konumlandıracak. (I964bb, b/436300273) - Bu davranışların yalnızca desteklenen kapsayıcılara uygulanabilmesini sağlamak için
PanelAPI'lerine Resizable ve Movable parametrelerini ekleyin. (Id491c) - Genişlik, yükseklik ve derinlik için tam minimum ve maksimum kısıtlamalar belirlemenize olanak tanıyan
sizeIn,widthIn,heightIn,depthInSubspaceModifiersözellikleri eklendi. (I1af09, b/433330761)
Sürüm 1.0.0-alpha06
13 Ağustos 2025
androidx.xr.compose:compose:1.0.0-alpha06 ve androidx.xr.compose:compose-testing:1.0.0-alpha06 yayınlandı. 1.0.0-alpha06 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
- Yaşam döngüsü sahibi yok edildiğinde
ComposeXrOwnerLocalsöğesini yeniden oluşturun. (9123ce1)
Sürüm 1.0.0-alpha05
30 Temmuz 2025
androidx.xr.compose:compose:1.0.0-alpha05 ve androidx.xr.compose:compose-testing:1.0.0-alpha05 yayınlandı. 1.0.0-alpha05 sürümü bu commit'leri içerir.
Yeni Özellikler
SubspaceComposableek açıklama sınıfını herkese açık hale getirdi. (Ic2a34, b/399432430)- 180 ve 360 derecelik küreleri temsil eden iki yeni
SpatialExternalSurfaceComposables. (I40ef2, b/391705799) SubspaceModifier.aspectRatioeklendi (Ide5ab, b/399729509, b/414762147)SceneCoreEntityAPI'si,SceneCoreile Compose for XR arasındaki birlikte çalışabilirliği artırmak için eklendi. (I50bb3, b/423020989)- Ölçeklendirilmemiş VE
GravityAlignedözelliğini desteklemek içinGravityAlignedsubspaceAPI sağlandı (I07359).
API Değişiklikleri
SpatialDialog(),SpatialDialogProperties.dismissOnBacktuşuna basma yapılandırmasını izler. (Ib453b, b/416797132)minimumPanelDimension, Metre cinsinden gösterildiği içinDimensions(0.1f, 0.1f, 0.1f)yeni varsayılan boyutuna güncellendi. (Ib852a)- Alt alanlar ve Orbiters artık ana alanda ve uygulama arka plandayken kendi iç durumlarını koruyacak. Ev alanı modunda, Subspace tam alan moduna geçişe hazırlanmak için sahnesini kurmaya devam eder. (I40317, b/416037751)
SpatialDialogsartık uygulama arka plandayken durumlarını koruyacak. (I6aa56)ApplicationSubspaceartık önerilen ölçeğini ve konumunu sistemden devralacak. (I4565f, b/418834194)SubspaceComposable,SubspaceComposableolmayan bir bağlamda kullanıldığında daha iyi bir hata mesajı eklendi ve hata daha erken tetikleniyor. (Iee2ae, b/416484684)- Composable API'ler yanlış kullanıldığında uyarılar genellikle gözden kaçırıldığından
ExperimentalSubspaceVolumeApiuyarısını hata olarak güncelledik. (I427aa, b/424864286) - Alt uzay ve
ApplicationSubspaceartıkrecommendedContentBoxInFullSpaceile sınırlanıyor. Daha önceSpatialUser'nın görüş alanı ile sınırlıydı. (I41015, b/423074142) SpatialElevationöğesini, sabit kodlanmış boyut kullanmayı bırakmak için minimum boyutu kullanacak şekilde güncelleyin (I2dbe6, b/427785338)- Önemli bir değişken değiştirildiğinde güncellenmesi için
SpatialAcitivityPanelile ilgili hazırlık maçlarımızı güncelleme. (I0f64d, b/427999029) - Varsayılan kısıtlama değerlerini eşdeğerine ayarlamak için
VolumeConstraints.Unboundedöğesini kaldırın. (Ie24ec, b/407938414) SpatialFeatheringSizeartık herkese açık değil (I1c15b, b/399432430)- Compose'un
Placeableöğesinden ayırt etmek için XRPlaceableöğesiniSubspacePlaceableolarak yeniden adlandırdı. (I74874) - Orbiter ayarlarını kaldırma ve
shouldRenderInNonSpatialöğesini yeni bir parametre olarak ekleme. Ayrıca,EdgeOffsetsınıfını kaldırıpOrbiter()işlevlerini birleştirmek içinorbiterOffsetTypesınıfını yeni bir parametre olarak ekliyoruz. AyrıcaOrbiterEdgedosyasınıContentEdgeolarak yeniden adlandırın. (Iebf3d) - Türün, Compose'un
Measurabletüründen ayırt edilebilmesi içinMeasurable,SubspaceMeasurableolarak yeniden adlandırıldı. (I9726c) MeasureResultfiltresiniSubspaceMeasureResultolarak yeniden adlandırın (I9f34d)setSubspaceContentAPI'si kaldırıldı. Bunun yerineSubspacecomposable'ı ile Compose'unsetContentkullanılması önerilir. (Ifff4c, b/421427391, b/421427391)MeasurePolicy,SubspaceMeasurePolicyolarak yeniden adlandırıldı. (I37a9b, b/422553904)- Varsayılanlar olmadan üye ekleyemeyeceğimiz için
SubspaceSemanticsInfo'ı kapalı bir arayüze dönüştürün. (I372f9, b/423704068) SpatialExternalSurfacedokümanları güncellendi,ContentSecurityLevel,SurfaceProtectionolarak yeniden adlandırıldı (I3c460, b/420982808)- Taşınabilir değiştirici için, sabitlemeye olanak tanıyan aşırı yüklenmiş oluşturucu sağlandı. (Ic0c70)
- İpuçları için daha fazla konum sağlayıcı eklendi. Böylece geliştiriciler, ipucunun bağlantının üstünde, altında, solunda veya sağında yerleştirilip yerleştirilmeyeceğini kontrol edebilir. Şapka işaretleri için bir Şekil alan bir API ekleyin. Böylece daha fazla özel şekil sağlanabilir. (Ie513c, b/374766087, b/418854637)
CoreEntity,PublishedApiolarak kaldırıldı (Ifee05)
Hata Düzeltmeleri
SpatialDialogsimgesinin oluşturulurken yanıp sönmesi sorunu düzeltildi. (Ife73c, b/401619909)SpatialDialogöğesinin Etkinlik Paneli'ni karartamaması sorunu düzeltildi. (I8ca6c, b/367442109)- XR iletişim kutusunda bazı içeriklerin gösterilmemesi sorunu düzeltildi (I17cd5, b/418062437).
- İçerikte tıklandığında
SpatialPopupöğesinin kapatılması sorunu düzeltildi. (If262c, b/417245722) resizable().movable()ile zincirleme yapıldığında SpatialPanel'in yeni boyuta doğru şekilde yeniden boyutlandırılamaması sorunu düzeltildi. (I02ee3, b/422264230)SpatialComposeVideoPlayer'deki menüyletopBar'nin çakışması sorunu düzeltildi (Id33bc, b/427168167).- Sabit köşe yarıçapının oluşturulmaması sorunu düzeltildi (I975fe, b/428261830).
Sürüm 1.0.0-alpha04
7 Mayıs 2025
androidx.xr.compose:compose:1.0.0-alpha04 ve androidx.xr.compose:compose-testing:1.0.0-alpha04 yayınlandı. 1.0.0-alpha04 sürümü bu commit'leri içerir.
Yeni Özellikler
- Özel
SubspaceModifiertürlerinin kompozisyon yerel değerlerine erişmesine olanak tanıyanCompositionLocalConsumerSubspaceModifierNodearayüzü eklendi. - Compose
AndroidViewuygulama stilini izleyen ve öncekiViewBased SpatialPanelAPI'nin desteğini sonlandıran yeni birSpatialPanelAPI eklendi. - Sınırsız kısıtlamaları temsil eden
VolumeConstraints.Unboundedyardımcı nesnesi eklendi. - Uzamsallaştırılmış ses kaynağına izin vermek için
SubspaceModifier.onPointSourceParamseklendi. - Herkese açık bir
ApplicationSubspaceeklendi. BuApplicationSubspace, uygulamanın mekansal içerik oluşturabileceği bir 3D alan tanımlamak için isteğe bağlıVolumeConstraintssunar. Varsayılan olarak, herhangi bir kısıtlama belirtilmezse alt uzay,SpatialUser'nın genişlik ve yükseklikteki mevcut görüş alanıyla sınırlanır. Kullanıcılar, görüş alanı belirlenemezse kullanılacak kısıtlamalar sağlayabilir. Aksi takdirde, varsayılan görüş alanı genişliği ve yüksekliği değerleri kullanılır. - Stereoskopik içerik oluşturmak için kullanılabilecek
SpatialExternalSurfaceeklendi.SpatialExternalSurface, değiştiricilerle (alfa hariç) ve kenar yumuşatma efektiyle özelleştirilebilir. - Kullanıcıların uzamsal işaretçinin simgesini ayarlamasına olanak tanıyan yeni bir
pointerHoverIconalt alan değiştiricisi eklendi.
API Değişiklikleri
- Tüm Jetpack XR paketlerindeki
RequiresApi(34)kısıtlaması kaldırıldı. Jetpack XR şu anda yalnızca API düzeyi 34 ve üzeri olan cihazlarda kullanılabildiğinden bu kısıtlama gereksizdi. (Iae0f8) - Kotlin 2.0 ile yayınlanan projelerin kullanılabilmesi için KGP 2.0.0 veya daha yeni bir sürüm gerekir. (Idb6b5)
- Geriye doğru işleme artık yerleştirilmiş etkinlikler içermeyen uzamsal panellerde çalışacak. Geriye gitme işleyicinin çalışması için Android manifest dosyasında
android:enableOnBackInvokedCallback="true"belirtmeniz gerekir. - Geriye doğru işleme artık uzamsal iletişim kutularında çalışacak. Geriye doğru işleme özelliğinin çalışması için Android manifestinde
android:enableOnBackInvokedCallback="true"belirtmeniz gerekir. - Compose tabanlı ve View tabanlı
SpatialPanelartık içeriklerine göre boyutlandırılabilir. - Geliştiriciler artık kendi özel
SpatialElevationLeveldeğerlerini ayarlayabilir ve önceden tanımlanmış seviyelerle sınırlı değildir. - Orbiter'ın yükseklik düzeyi artık
elevationparametresiyle özelleştirilebilir. - Alt alan artık varsayılan olarak
SpatialUser'nın genişlik ve yükseklik açısından görüş alanıyla sınırlanabilir. Görüş alanı belirlenemezse varsayılan görüş alanı genişliği ve yüksekliği değerleri kullanılır. Movabledeğiştiricisine yeni geri çağırmalaronMoveStartveonMoveEndeklendi.onMoveStartveonMoveEndgeri çağırmaları, kullanıcı taşınabilir değiştiriciyle birleştirilebilen bir alt alanı taşımaya başladığında ve taşımayı bitirdiğinde çağrılır.nameparametresi,SpatialRowveSpatialPanelgibi uzamsal API'lerden kaldırıldı. Uzamsal Compose ağaçlarında hata ayıklamak için bunun yerineSubspaceModifier.testTagkullanın.- Yalnızca
spatialElevationLevelvecontentiçeren, desteklenmeyen birSpatialPopupaşırı yüklemesi kaldırıldı. LütfenonDimissRequestsimgesini destekleyen arayüzü kullanın. - Movable değiştiricisinden gelen
onPoseChangegeri çağırma kaldırıldı. Bunun yerineonMovepolitikasını kullanın. SubspaceModifiers, ayrılmışsa veya şu anda ayrılıyorsa efektlerini artık uygulamaz.- Mevcut
SpatialRowAPI'siSpatialRowveSpatialCurvedRowolarak ikiye bölündü. Daha önceSpatialRow'nıncurveRadiusparametresini kullanıyorsanız artık aynı davranışı sunanSpatialCurvedRowparametresini kullanın. MainPanelveActivityPanel, benzer şekilde yeni bir sistem görüntüsünde çalıştırıldığında artık başlık çubuğuna sahip değildir.- Alfa ve ölçek değiştiriciler artık yığılabilir ve son uygulanan alfa veya ölçek değeri için değerlerini çarpacaktır.
onPoseChangeTaşınabilir değiştiriciden gelen geri çağırma, daha sorunsuz poz hareketi için optimize edildi.- Taşınabilir ve yeniden boyutlandırılabilir değiştiriciler artık durum değişikliklerinin yeniden oluşturmayı tetiklemesini sağlamak için geri çağırmalarını ana iş parçacığında gerçekleştirecek.
SubspaceLayoutiçindeki durum değişikliklerinin yeniden düzenlemeyi tetiklemesini sağlamak için düzen ve ölçüm aşamalarına durum gözlemi eklendi.- Mevcut değiştiricilerin daha iyi yeniden kullanılması için optimize edilmiş değiştirici zinciri güncellemeleri.
Hata Düzeltmeleri
SpatialDialoggösterildiğinde karartma durdurulur. (Ic4594)- Değiştirici düğümler ayrılmış durumdayken yapılan yeniden düzenleme istekleri artık yoksayılacak.
- Taşınabilir ve Yeniden Boyutlandırılabilir değiştiricileri tarafından tetiklenen yeniden düzenleme aşamaları kaldırıldı.
- Boyutlardan biri doğrudan veya düzen hesaplaması sırasında (ör.
SpatialRow/SpatialColumnhesaplaması) sıfıra ayarlandığında oluşanMainPanel()composable'daki kilitlenme sorunu düzeltildi. Panel artık gizlenecek. Bu düzeltmenin özellikle düzen aşamasındaki kilitlenmeleri ele aldığını unutmayın. Panelin kullanıcı etkileşimi yoluyla sıfıra yeniden boyutlandırılması ayrı olarak ele alınacaktır. Gizli panelde kullanıcı arayüzü olanakları yok. - Yeniden boyutlandırılabilir değiştiriciden
maintainAspectRatioile ilgili sorun düzeltildi. En boy oranı korunmalıdır. - İç içe yerleştirilmiş alt uzayların tek bir kare için yanlış konumlandırılmasına neden olan sorun düzeltildi.
- Yuvarlak köşelerin bazen uygulanması gerektiği halde uygulanmaması sorunu düzeltildi.
NestedSubspacesartık yanlış konumdaki bir karede görünmeyecek.
Sürüm 1.0.0-alpha03
26 Şubat 2025
androidx.xr.compose:compose:1.0.0-alpha03 ve androidx.xr.compose:compose-testing:1.0.0-alpha03, son alfa sürümünden bu yana önemli bir değişiklik yapılmadan yayınlandı. 1.0.0-alpha03 sürümü bu commit'leri içerir.
Sürüm 1.0.0-alpha02
12 Şubat 2025
androidx.xr.compose:compose:1.0.0-alpha02 ve androidx.xr.compose:compose-testing:1.0.0-alpha02 yayınlandı. 1.0.0-alpha02 sürümü bu commit'leri içerir.
Yeni Özellikler
- Etkinlik paneli, artık bir mekansal iletişim kutusu etkinleştirildiğinde içeriğini karartabilir.
OrbiterAPI artıkSubspaceComposablebağlamlarında kullanılabilir ve Orbiters'ı en yakınSubspaceLayouttabanlı composable üst öğeye ekler.- Özel konumlandırmaya dayalı değiştiricilere izin vermek için
LayoutCoordinatesAwareModifierNodetanıtıldı. SubspaceModifier.Nodeiçin ekleme/ayırma yaşam döngüsü yöntemleri eklendi.scaleWithDistance, taşınabilir değiştiriciye eklendi.scaleWithDistanceetkinleştirildiğinde, taşınan alt alan öğesi büyür veya küçülür. Ayrıca, hareketten önce sahip olduğu açık ölçeği de korur.
API Değişiklikleri
SessionCallbackProvider,SpatialCapabilitieslehine kaldırıldı.
Diğer değişiklikler
minSDKdeğeri 24'e düşürüldü. Tüm Jetpack XR API'leri, çalışma zamanında API 34 gerektirmeye devam eder.OrbiterEdgeOffset.inner,EdgeOffset.outerveEdgeOffset.overlapoluşturucular artık@Composableyöntemleri değildir. Bu sayede, oluşturucular birleştirilemeyen bağlamlarda kullanılabilir.- Uzamsal Yükseklik Düzeylerini en yeni kullanıcı deneyimi spesifikasyonuna uyacak şekilde güncelleyin.
SubspaceSemanticsInfoarayüzünüMeasurableLayout'ye uygulayın.SubspaceModifierElement,SubspaceModifierNodeElementolarak yeniden adlandırıldı.
Hata düzeltmeleri
SubspaceModifiersıralamasını sabitlemeye yönelik düzeltmeler.SubspaceModifierdaha güvenilir bir şekilde çalışır. Öteleme, döndürme, ölçeklendirme, taşınabilir ve yeniden boyutlandırılabilir değiştiriciler artık herhangi bir sırada kullanılabilir.
Sürüm 1.0.0-alpha01
12 Aralık 2024
androidx.xr.compose:compose-*1.0.0-alpha01 iptal edilir.
İlk Sürümün Özellikleri
XR için Jetpack Compose'un ilk geliştirici sürümü. İster mevcut bir 2D uygulamayı XR'ye taşıyor ister sıfırdan yeni bir XR uygulaması oluşturuyor olun, XR'de mekansal kullanıcı arayüzü düzenleri oluşturmak için satırlar ve sütunlar gibi tanıdık Compose kavramlarını kullanın. Bu kitaplık, mevcut 2D Compose veya Görünümler tabanlı kullanıcı arayüzünüzü uzamsal bir düzene yerleştirmenize olanak tanıyan alt alan ve uzamsal composable'lar (ör. uzamsal paneller ve yörüngeler) sağlar. 3D modeller gibi SceneCore öğelerini kullanıcı arayüzünüze göre yerleştirmenize olanak tanıyan Volume subspace composable'ı kullanıma sunar. Daha fazla bilgiyi bu geliştirici kılavuzunda bulabilirsiniz:
Subspace: Bu composable, uygulamanızın kullanıcı arayüzü hiyerarşisinde herhangi bir yere yerleştirilebilir. Böylece, dosyalar arasındaki bağlamı kaybetmeden 2D ve uzamsal kullanıcı arayüzü düzenlerini koruyabilirsiniz. Bu sayede, mevcut uygulama mimarisi gibi öğeleri tüm kullanıcı arayüzü ağacınızda durumu yükseltmenize veya uygulamanızın mimarisini yeniden tasarlamanıza gerek kalmadan XR ve diğer form faktörleri arasında daha kolay paylaşabilirsiniz.SpatialPanel: SpatialPanel, uygulama içeriğini görüntülemenize olanak tanıyan bir alt uzay bileşenidir. Örneğin, video oynatma, hareketsiz görüntüler veya diğer içerikleri SpatialPanel'de görüntüleyebilirsiniz.
Orbiter: Orbiter, uzamsal bir kullanıcı arayüzü bileşenidir. İlgili bir uzamsal panele eklenmek üzere tasarlanmıştır ve bu uzamsal panelle ilgili gezinme ve bağlamsal işlem öğelerini içerir. Örneğin, video içeriğini göstermek için bir uzamsal panel oluşturduysanız yörüngeye video oynatma kontrolleri ekleyebilirsiniz.
Hacim: 3D modeller gibi SceneCore öğelerini kullanıcı arayüzünüze göre yerleştirin.
Uzamsal Yerleşim:
SpatialRow,SpatialColumn,SpatialBoxveSpatialLayoutSpacerkullanarak birden fazla uzamsal panel oluşturabilir ve bunları Uzamsal Yerleşim'e yerleştirebilirsiniz. Düzeninizi özelleştirmek içinSubspaceModifiersimgesini kullanın.Uzamsal kullanıcı arayüzü bileşenleri: Bu öğeler 2D kullanıcı arayüzünüzde yeniden kullanılabilir ve uzamsal özellikleri yalnızca uzamsal özellikler etkinleştirildiğinde görünür.
SpatialDialog: Panel, yükseltilmiş bir iletişim kutusu göstermek için z derinliğinde biraz geriye itilir.SpatialPopUp: Panel, yükseltilmiş bir pop-up göstermek için z derinliğinde biraz geriye itilir.SpatialElevation:SpatialElevationLevel, yüksekliği eklemek için ayarlanabilir.
SpatialCapabilities: Kullanıcılar uygulamanızla veya sistemle etkileşimde bulundukça mekansal özellikler değişebilir, hatta uygulamanızın kendisi tarafından da değiştirilebilir (ör. Ev Alanı'na veya Tam Alan'a geçiş). Sorun yaşamamak için uygulamanızın, mevcut ortamda hangi API'lerin desteklendiğini belirlemek üzere
LocalSpatialCapabilities.currentolup olmadığını kontrol etmesi gerekir.isSpatialUiEnabled: Üç boyutlu kullanıcı arayüzü öğeleri (ör. SpatialPanel)isContent3dEnabled: 3D nesnelerisAppEnvironmentEnabled: OrtamisPassthroughControlEnabled: Uygulamanın, geçiş durumunu kontrol edip edemeyeceğiisSpatialAudioEnabled: Üç boyutlu ses
Bilinen Sorunlar
- Şu anda XR için Jetpack Compose'u kullanmak üzere minimum SDK sürümü 30 olmalıdır. Geçici çözüm olarak, 23 minSDK ile derleme ve çalıştırma yapabilmek için aşağıdaki manifest girişini
<uses-sdk tools:overrideLibrary="androidx.xr.scenecore, androidx.xr.compose"/>ekleyebilirsiniz. - Jetpack XR uygulamalarının şu anda AndroidManifest'te
android.permission.SCENE_UNDERSTANDINGizni istemesi gerekiyor. - Bir uygulama, manifest dosyasındaki
PROPERTY_XR_ACTIVITY_START_MODEözelliğini kullanarak doğrudan Tam Alan'da başlatıldığında Etkinlikler/Uygulamalar, Tam Alan'a geçmeden önce başlangıçta Ev Alanı'nda açılır. - Volume Composables'daki glTF'ler başlangıçta yanlış konumda titreyebilir.
- Önemli ölçüde taşınmış bir panelde SpatialDialog kullanmak, içeriği yanlış yöne iter.