Jetpack SceneCore

3D içeriklerle Android XR sahne grafiğini oluşturun ve değiştirin.
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 SceneCore'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:

Groovy

dependencies {
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha08"

    // Optional dependencies for asynchronous conversions
    implementation "androidx.xr.scenecore:scenecore-guava:1.0.0-alpha08"

    // Use to write unit tests
    testImplementation "androidx.xr.scenecore:scenecore-testing:1.0.0-alpha08"
}

Kotlin

dependencies {
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha08")

    // Optional dependencies for asynchronous conversions
    implementation("androidx.xr.scenecore:scenecore-guava:1.0.0-alpha08")

    // Use to write unit tests
    testImplementation("androidx.xr.scenecore:scenecore-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.

Yeni sorun oluşturma

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.scenecore:scenecore-*:1.0.0-alpha08 iptal edilir. 1.0.0-alpha08 sürümü bu commit'leri içerir.

API Değişiklikleri

  • ActivityPanelEntity.moveActivity, transferActivity olarak yeniden adlandırıldı (I273c5, b/430332856)

Hata Düzeltmeleri

  • :xr:scenecore:scenecore-spatial-rendering ve :xr:scenecore:scenecore-spatial-core, :xr:scenecore:scenecore'nin (I6ab65, b/447000520) uygulama bağımlılığı olarak eklendi.
  • Oturum yok edildikten sonra session.scene erişilirse istisna oluşturulur. (I77e6f)

Sürüm 1.0.0-alpha07

24 Eylül 2025

androidx.xr.scenecore:scenecore:1.0.0-alpha07, androidx.xr.scenecore:scenecore-guava:1.0.0-alpha07 ve androidx.xr.scenecore:scenecore-testing:1.0.0-alpha07 özellikleri kullanıma sunulur. 1.0.0-alpha07 sürümü bu commit'leri içerir.

API Değişiklikleri

  • fixedAspectRatio, isFixedAspectRatioEnabled olarak yeniden adlandırıldı ve Boole özelliği haline getirildi (I5c4e8, b/440588971)
  • Scenecore Sahteler artık xr:scenecore:scenecore-testing modülünde yer alıyor. (Idd951)
  • shouldAutoHideContent, isAutoHideContentWhileResizingEnabled, shouldAlwaysShowOverlay ve isAlwaysShowOverlayEnabled olarak yeniden adlandırıldı (I97c36, b/432335421)
  • Okunabilirlik için SceneCore TextureSampler sabitleri güncellendi. Örneğin, TextureSampler.MinFilter.LINEAR artık TextureSampler.MIN_FILTER_LINEAR (Ib159c) olarak kullanılıyor.
  • Sahnenin setKeyEntity ayarlayıcısı, keyEntity değişkeniyle birleştirildi. keyEntity öğesini AnchorEntity gibi taşınamayan bir öğeye ayarlamak, boole yanlış değeri döndürmek yerine IllegalArgumentException hatası verir. (I62080, b/428721695, b/422215745)
  • Sahnenin SpatialModeChangeListener değişkeni, setSpatialModeChangedListener ile değiştirildi. SpatialModeChangedListener yerine Consumer<SpatialModeChangeEvent> alır. setSpatialModeChangedListener artık isteğe bağlı olarak bir Executor alabilir. (I62080, b/428721695, b/422215745)
  • bundle parametresi ActivityPanelEntity.startActivity öğesinden kaldırıldı (I64344, b/430332856, b/430333040).
  • SpatializerConstants.SOURCE_TYPE_BYPASS, SpatializerConstants.SOURCE_TYPE_DEFAULT olarak yeniden adlandırıldı. (Ifc7fe, b/422215565)
  • SpatialSoundPool.PLAY_FAILED sabiti eklendi. (Ifc7fe, b/422215565)
  • SpatialSoundPool.play yöntemlerine varsayılan bağımsız değişkenler eklendi. (Ifc7fe, b/422215565)
  • SpatialAudioTrackBuilder içindeki ayarlayıcıların döndürülen değeri kaldırıldı. (Ifc7fe, b/422215565)
  • SurfaceEntity değişiklikleri
    • SurfaceEntity.CanvasShape, Shape olarak yeniden adlandırıldı
    • SurfaceEntity.CanvasShape.Vr180Hemisphere, Hemisphere olarak yeniden adlandırıldı
    • SurfaceEntity.CanvasShape.Vr360Sphere, Sphere olarak yeniden adlandırıldı
    • SurfaceEntity.EdgeFeatheringParams.SmoothFeather, RectangleFeather olarak yeniden adlandırıldı
    • SurfaceEntity.EdgeFeathingParams.SolidEdge, NoFeathering olarak yeniden adlandırıldı
    • SurfaceEntity.ContentSecurityLevel, SurfaceProtection olarak yeniden adlandırıldı
    • SurfaceEntity.ContentSecurityLevel.{values}, SURFACE_PROTECTION_ önekini ekledi.
    • SurfaceEntity.SuperSampling.{$values}, SUPER_SAMPLING_ önekini ekledi
    • SurfaceEntity.StereoMode.{values}, STEREO_MODE_ önekini ekledi
    • SurfaceEntity.ContentColorMetadata.maxCLL, maxContentLightLevel olarak yeniden adlandırıldı (I7eb5f, b/422216050, b/427529950)
  • launchActivity, startActivity olarak yeniden adlandırıldı (I7db90, b/430332856)
  • Scene.activitySpaceRoot kaldırıldı. Bunun yerine Scene.activitySpace politikasını kullanın. (I05ee8, b/378706624, b/422215745)
  • configureBundleForFullSpaceModeLaunch ve configureBundleForFullSpaceModeLaunchWithEnvironmentInherited sırasıyla createBundleForFullSpaceModeLaunch ve createBundleForFullSpaceModeLaunchWithEnvironmentInherited olarak yeniden adlandırıldı ve üst düzey yöntemler olarak LaunchUtils.kt dosyasına taşındı. İlk parametre olarak Session'ı alır (I64a2c, b/437186050).
  • GroupEntity factory artık Entity yerine GroupEntity türünü döndürüyor. (I66042)

Hata Düzeltmeleri

Sürüm 1.0.0-alpha06

13 Ağustos 2025

androidx.xr.scenecore:scenecore:1.0.0-alpha06, androidx.xr.scenecore:scenecore-guava:1.0.0-alpha06 ve androidx.xr.scenecore:scenecore-testing:1.0.0-alpha06 özellikleri kullanıma sunulur. 1.0.0-alpha06 sürümü bu commit'leri içerir.

API Değişiklikleri

  • SceneCore'nın BaseEntity ve BaseScenePose API'lerindeki kısıtlamaları kaldırın (88c0ff6)

Sürüm 1.0.0-alpha05

30 Temmuz 2025

androidx.xr.scenecore:scenecore-guava:1.0.0-alpha05, androidx.xr.scenecore:scenecore-testing:1.0.0-alpha05 ve androidx.xr.scenecore:scenecore:1.0.0-alpha05 özellikleri kullanıma sunulur. 1.0.0-alpha05 sürümü bu commit'leri içerir.

Yeni Özellikler

  • Panel Varlıkları ve SurfaceEntities'ya Algılanan Çözünürlük API'si eklendi. (I118f6)
  • PerceivedResolution HSM'deki etkinliğin ana panelinin algılanan çözünürlüğünü izlemek için Scene.kt'ye geri çağırma yöntemleri eklendi. (I58084)
  • SurfaceEntity - Oluşturma sırasında süper örnekleme isteğinde bulunma uygulaması için destek eklendi. Bu, uygulamaların kenar yumuşatma için süper örnekleme filtresi kullanmasına olanak tanır. (I06913)
  • ActivitySpace listesine recommendedContentBoxInFullSpace özelliği eklendi. Tam Alan Modu'nda yerleştirilecek içerikler için önerilen bir kutu döndürür. (I4cd6f)
  • Taşınabilir değiştirici için, sabitlemeye olanak tanıyan aşırı yüklenmiş oluşturucu sağlandı. (Ic0c70)

API Değişiklikleri

Bu sürümde SceneCore'da kapsamlı API değişiklikleri yapıldı. Birkaç sınıf yeniden adlandırıldı ve/veya farklı modüllere taşındı. Çoğu getter/setter yöntemi Kotlin özellikleri ile değiştirildi. İlk beta sürümümüz yayınlanana kadar gelecekte API'de uyumluluğu bozan değişiklikler olacağını tahmin etsek de bu değişiklikler o kadar rahatsız edici veya çok sayıda olmayacak.

  • Aşağıdaki sınıfların ve arayüzlerin adları değiştirildi ve/veya taşındı: androidx.xr.scenecore.PixelDimensions - androidx.xr.runtime.math.IntSize2d; androidx.xr.scenecore.Dimensions - androidx.xr.runtime.math.FloatSize3d; androidx.xr.scenecore.ActivityPose - ScenePose, androidx.xr.scenecore.ContentlessEntity - GroupEntity, androidx.xr.scenecore.PlaneType - PlaneOrientation; androidx.xr.scenecore.PlaneSemantic - PlaneSemanticType. (Ifd405)(I3b622) (If534d)
  • Scene özelliklerinin bir dizi ayarlayıcısı, SceneCore istemcileri tarafından değiştirilmemesi amaçlandığından gizli hale getirildi: activitySpace, activitySpaceRoot, mainPanelEntity, perceptionSpace, spatialCapabilities, spatialEnvironment ve spatialUser. (I2f506)
  • Varlıkta: get/setParent(), setContentDescription özellikleri değiştirildi. Entity.is/setHidden() özelliği kullanımdan kaldırıldı, bunun yerine Entity.is/setEnabled özelliği kullanılıyor. (Ibc4c6)
  • androidx.xr.scenecore.BasePanelEntity sınıfı kaldırıldı. Bunun yerine doğrudan PanelEntity kullanın. PanelEntity için alıcılar ve ayarlayıcılar özelliklerle değiştirildi. PanelEntity.size özelliği, Float3dSize olan önceki değerden Float2dSize olarak değiştirildi. Desteği sonlandırılan androidx.xr.scenecore.PanelEntity.getPixelDimensions yöntemi kaldırıldı. Bunun yerine getSizeInPixels yöntemini kullanın. (Icc174)
  • androidx.xr.scenecore.OnSpaceUpdatedListener, Runnable ile değiştirildi. (I19308)
  • SpatialUser.getCameraViews() öğesi bir mülkle değiştirildi. (Ib0cc5) ExrImage ve GltfModel: için create yöntemleri askıya alma işlevleri olarak değiştirildi; oluşturma parametreleri, String yerine Uri veya Path kabul edecek şekilde değiştirildi. (Id8883) (I0d247), (I25706)
  • SpatialEnvironment.requestFullSpaceMode ve SpatialEnvironment.requestHomeSpaceMode, Sahne'ye taşındı. Örneğin, session.scene.spatialEnvironment.requestFullSpaceMode() yerine session.scene.requestFullSpaceMode() kullanın. addOnPassthroughOpacityChangedListener ve addOnSpatialEnvironmentChangedListener artık isteğe bağlı Executor'ları kabul eden geçersiz kılma işlemlerine sahip. (I12fe0) (I6b21e)
  • Kullanımdan kaldırılan şu SpatialEnvironment yöntemleri kaldırıldı: togglePassthrough, setPassthrough, setPassthroughOpacity, getPassthroughMode, getPassthroughOpacity, setSkybox ve setGeometry. Ayrıca, kullanımdan kaldırılan SpatialEnvironment.PassthroughMode (I927bd) (I927bd) (I927bd) sınıfı da kaldırıldı.
  • Aşağıdaki SpatialEnvironment alıcılar ve ayarlayıcılar Kotlin özellikleriyle değiştirildi: getCurrentPassthroughOpacity(), get/setPassthroughOpacityPreference(), get/setSpatialEnvironmentPreference(), isSpatialEnvironmentPreferenceActive() (I33a7b) (Ie06e2) (Ie06e2)
  • SpatialEnvironmentPreference.preferredPassthroughOpacity türü Float? olarak değiştirildi.Float Artık boş değerler kabul edilmiyor. Bunun yerine, opaklık tercihi olmadığını belirtmek için SpatialEnvironment.NO_PASSTHROUGH_OPACITY_PREFERENCE kullanılır. (I40107)
  • Oluşturma yönteminde windowBoundsPx parametresi pixelDimensions olarak, türü ise Rect'ten IntSize2d olarak güncellendi. (I1926e)
  • SpatialEnvironment oluşturucusu artık dahili (I75a51)
  • SpatialPointerIconNone ve SpatialPointerIconCircle sınıfları, yardımcı nesneler SpatialPointerIcon.NONE ve SpatialPointerIcon.CIRCLE ile değiştirildi (I416d2).
  • SpatialPointerComponent içindeki SpatialPointerIcon artık boş değer içermez. Sistem varsayılanı işaretçi simgesinin kullanılması gerektiğini belirtmek için null yerine SpatialPointerIcon.DEFAULT değerini kullanın. (I416d2)
  • androidx.xr.scenecore.AnchorEntity.getState(), salt okunur bir özellik ile değiştirildi. AnchorEntity.create() yöntemindeki parametreler daha anlaşılır olacak şekilde yeniden adlandırıldı. AnchorEntity'nın işleyici ayarlama ve ekleme yöntemlerinde, sondaki lambda'ların etkinleştirilmesi için işleyici son bağımsız değişkene taşındı. AnchorEntity için androidx.xr.scenecore.OnStateChangedListener yerine Consumer<AnchorEntity.State> kullanıldı. (I472e0)
  • GltfModelEntity.getAnimationState() artık bir mülk. (I10b29)
  • ActivitySpace.getBounds() öğesi bir mülkle değiştirildi. ActivitySpace.addBoundsChangedListener, ActivitySpace.addOnBoundsChangedListener olarak yeniden adlandırıldı. ActivitySpace.setOnSpaceUpdatedListener, ekleme/kaldırma yöntemleriyle değiştirildi. (I4c956)
  • AnchorPlacement: planeTypeFilter olan ad anchorablePlaneOrientations, planeSemanticFilter olan ad anchorablePlaneSemanticTypes olarak değiştirildi. AnchorEntity veya ActivitySpace işlevine MovableComponent eklenmesi "yanlış" değerini döndürür, MoveListener işlevinin adı EntityMoveListener shouldDisposeParentAnchor olarak değiştirildi, EntityMoveListener shouldDisposeParentAnchor işlevinin adı disposeParentOnReAnchor systemMovable olarak değiştirildi, disposeParentOnReAnchor systemMovable işlevi creeateCustomMovable, createSystemMovable ve createAnchorable işlevleri lehine create işlevinden kaldırıldı (If11c4)
  • SurfaceEntity.featherRadiusX/Y kaldırılır ve EdgeFeatheringParams sınıfı kavramı eklenir. (Ic78fc)
  • PanelEntity.enablePanelDepthTest() yöntemi, panelClippingConfig özelliğiyle değiştirildi. Derinlik testini etkinleştirmek için Scene.panelClippingConfig = PanelClippingConfig(isDepthTestEnabled = true), devre dışı bırakmak için PanelClippingConfig(isDepthTestEnabled = false) olarak ayarlayın. (I0cbe0)
  • Scene.mainPanelEntity artık PanelEntity yerine MainPanelEntity türünde (I7125a)
  • Scene sınıfının setFullSpaceMode yöntemi configureBundleForFullSpaceModeLaunch, setFullSpaceModeWithEnvironmentInherited yöntemi ise configureBundleForFullSpaceModeLaunchWithEnvironmentInherited olarak yeniden adlandırıldı. (I0cbe0) (I0cbe0)
  • SpatialVisibility'nın UNKNOWN, OUTSIDE_FOV, PARTIALLY_WITHIN_FOV ve WITHIN_FOV değerleri sırasıyla SPATIAL_VISIBILITY_UNKNOWN, SPATIAL_VISIBILITY_OUTSIDE_FIELD_OF_VIEW, SPATIAL_VISIBILITY_PARTIALLY_WITHIN_FIELD_OF_VIEW ve SPATIAL_VISIBILITY_WITHIN_FIELD_OF_VIEW olarak yeniden adlandırıldı (Ie7e8c).
  • SpatialVisibility sınıfı, sabit int değerlerine sahip genel nesneyle değiştirildi. setSpatialVisibilityChangedListener artık Consumer<SpatialVisibility> yerine Consumer<Int> kabul ediyor (Ie7e8c)
  • PointerCaptureComponent sabiti yeniden adlandırıldı ve PointerCaptureComponent.PointerCaptureState nesnesine taşındı (I9c7ac)
  • PointerCaptureComponents' StateListener, Consumer<Int> ile değiştirildi. (I9c7ac)
  • InputEventListener, Consumer<InputEvent> ile değiştirildi (I9c7ac)
  • setPreferredAspectRatio, Scene sınıfından SpatialWindow nesnesine taşındı ve ilk parametre olarak Session'ı alıyor. (I7b717)
  • Entity.setHidden(), Entity.setEnabled() ile, Entity.isHidden() ise Entity.isEnabled() ile değiştirildi. setHidden(false), setEnabled(true) ve isHidden() == !isEnabled() değerine eşittir. (Icf0de)
  • Entity.contentDescription türü, String'den CharSequence olarak değiştirildi. (Ie59be)
  • Session.create ve Session.configure artık SessionCreatePermissionsNotGranted veya SessionConfigurePermissionsNotGranted değerini döndürmek yerine yeterli izin verilmediğinde SecurityException değerini döndürüyor. (I7c488)
  • ResizableComponent.create artık Consumer<ResizeEvent> ResizeEventListener gerektiriyor. Consumer<ResizeEvent> ResizableComponent.size, ResizableComponent.affordanceSize ResizableComponent.minimumSize olarak yeniden adlandırıldı. ResizableComponent.minimumEntitySize ResizableComponent.maximumSize, ResizableComponent.maximumEntitySize olarak yeniden adlandırıldı. ResizableComponent.autoHideContent, ResizableComponent.shouldAutoHideContent olarak yeniden adlandırıldı. ResizableComponent.forceShowResizeOverlay, ResizableComponent.shouldAlwaysShowOverlay olarak yeniden adlandırıldı (I97a2d).
  • minSDK, androidx.xr.scenecore ve androidx.xr.compose için 24'e düşürüldü. XR paketleri, çalışma zamanında hâlâ API 34'ü gerektirir. (I17224)
  • 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)
  • Ana SceneCore yapısı (xr:scenecore:scenecore) yalnızca Kotlin tarzı eş zamansız API'ler içerir. Java geliştiriciler, uyumlu API'lere erişmek için xr:scenecore:scenecore-guava kitaplığını kullanabilir. (If221b)
  • Kotlin 2.0 ile yayınlanan projelerin kullanılabilmesi için KGP 2.0.0 veya daha yeni bir sürüm gerekir (Idb6b5).
  • Bu kitaplık artık tür kullanımı olan JSpecify nullness ek açıklamalarını kullanıyor. Kotlin geliştiricileri, doğru kullanımı zorunlu kılmak için aşağıdaki derleyici bağımsız değişkenini kullanmalıdır: -Xjspecify-annotations=strict (bu, Kotlin derleyicisinin 2.1.0 sürümünden itibaren varsayılan değerdir) (Ia8420)
  • ListenableFuture döndüren tüm asenkron yöntemler, Kotlin'in askıya alma işlevleriyle değiştirildi. Kotlin'in askıya alma işlevleri yerine ListenableFuture tabanlı asenkron yöntemler kullanmak isteyen Java geliştiricilerin artık :xr:scenecore-scenecore-guava'deki uzantı işlevlerini kullanması gerekiyor. Örneğin, GuavaExrImage, Guava'ya eşdeğer ExrImage asenkron işlevlerini, GuavaScenePose, Guava'ya eşdeğer ScenePose asenkron işlevlerini, GuavaGltfModel ise Guava-equivalent GltfModel asenkron işlevlerini içerir. (If7283) (I0af60) (If7283) (Ia8515) (I4efdf) (I54bbf) (I3467a) (I82a33)

Hata Düzeltmeleri

  • Küçültülmüş istemcilerde AbstractMethodError sorununu önlemek için güncellenmiş Jetpack XR Scenecore ProGuard kuralı. (I91a01)
  • Jetpack XR için Proguard küçültmesini desteklemeye yönelik ek düzeltmeler SceneCore (I4f47e)
  • Sistemden döndürülen hitPosition değeri boşsa (null) InputEvent HitInfo'nun hitPosition değerinin InteractableComponent çökmesine neden olabileceği hata düzeltildi (I7a695).
  • Yapılandırma *Modu değerleri, davranışlarını yansıtacak şekilde yeniden adlandırıldı. (I6d247)
  • SceneCore TestApp'te FOV ve HitTest ile ilgili sorunlar düzeltildi. (I2c51e)
  • SpatialCapabilities.hasCapability() işlevinde, bit düzeyinde VEYA ile iletilen özelliklerden herhangi biri doğruysa yalnızca tüm özellikler doğru olduğunda doğru değerini döndürmesi gerekirken doğru değerini döndürmesine neden olan hata düzeltildi. (I2cd40)
  • SurfaceEntity.StereoMode.TOP_BOTTOM, üstteki harita sol gözde, alttaki harita ise sağ gözde olacak şekilde güncellendi. (I4ae68)

Sürüm 1.0.0-alpha04

7 Mayıs 2025

androidx.xr.scenecore:scenecore:1.0.0-alpha04 ve androidx.xr.scenecore:scenecore-testing:1.0.0-alpha04 yayınlandı. 1.0.0-alpha04 sürümü bu commit'leri içerir.

Yeni Özellikler

  • Geriye dönük işleme artık yerleştirilmiş etkinlikler içermeyen panel öğelerinde çalışacak. Geriye doğru işleme özelliğinin çalışması için Android manifestinde android:enableOnBackInvokedCallback= "true" belirtmeniz gerekir.
  • StereoSurfaceEntity artık iki yeni StereoMode değeri (MULTIVIEW_LEFT_PRIMARY ve MULTIVIEW_RIGHT_PRIMARY) aracılığıyla MV-HEVC oynatmayı destekliyor.
  • PanelEntity.setSize ve PanelEntity.getSize artık üst alandaki boyutları döndürüyor.
  • Entity.setPose, Entity.getPose, Entity.setScale, Entity.getScale, Entity.setAlpha ve Entity.getAlpha artık farklı alanlara göre değerleri alma/ayarlama işlemlerine olanak tanıyan yeni bir parametre relativeTo alıyor. Desteklenen değerler üst, etkinlik ve gerçek dünya alanlarıdır. Bu parametrenin varsayılan değeri üst öğedir.
  • Sahne içeriğinin kullanıcının görüş alanının içine veya dışına taşındığı zamanı izlemek için SessionExt.kt'ya Spatial Visibility Callback uzantı yöntemleri eklendi.
  • setPointSourceParams, SpatialAudioTrack adlı parçaya eklendi. Bu sayede, parça oluşturulduktan sonra parametreler güncellenebilir.
  • Scenecore API'lerine referanslar içeren yeni bir sınıf (Sahne) eklendi. Sahne, oturumun bir uzantı özelliği olarak erişilebilir. SessionExt içindeki işlevler Scene'e taşındı. Bu nedenle, içe aktarmaların ayarlanması gerekecek. Örneğin, SessionExt.getScene(session).addSpatialCapababilitiesChangedListener - SessionExt.addSpatialCapabilitiesChangedListener.
  • ActivityPose.hitTestAsync eklendi. Bu sayede sanal içeriklere karşı hitTest kullanılabiliyor.
  • Yeni bileşen türü SpatialPointerComponent eklendi. Bu tür, müşterilerin işaretçi için oluşturulan simgeyi belirtmesine veya simgeyi devre dışı bırakmasına olanak tanır. Bu Bileşen şu anda yalnızca PanelEntity örneğe eklenebilir.
  • Yeni PanelEntity fabrika işleviyle tanışın. Bu işlev, panel boyutlarını metre veya piksel cinsinden alır. Panel için iki boyut türü parametresi alan eski PanelEntity fabrikası kaldırıldı.

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).
  • PermissionHelper sınıfı kaldırıldı.
  • PanelEntity.getPixelDensity desteği sonlandırıldı.
  • PanelEntity.setPixelDimensions ve PanelEntity.getPixelDimension kaldırıldı, yerini setSizeInPixels ve getSizeInPixels aldı.
  • Entity.getActivitySpaceAlpha kaldırıldı. Entity.getAlpha(Space.Activity) ile değiştirilebilir.
  • Entity.getWorldSpaceScale kaldırıldı. Entity.getScale(Space.REAL\_WORLD) ile değiştirilebilir.
  • SceneCore içindeki Oturum sınıfı, XR Runtime'daki Oturum sınıfı lehine silindi.
  • StereoSurfaceEntity, SurfaceEntity olarak yeniden adlandırıldı.
  • Entity.setSize ve Entity.getSize kaldırıldı. Aynı yöntemler PanelEntity için eklendi.
  • PointSourceAttributes, PointSourceParams olarak yeniden adlandırıldı.
  • SpatializerConstants.SOURCE\_TYPE\_BYPASS, SpatializerConstants.SOURCE\_TYPE\_DEFAULT olarak yeniden adlandırıldı.
  • PointSourceParams öğesinin erişimi herkese açık yerine kuruluş içi olarak değiştirildi.
  • AnchorEntity.create artık Session.configure() içinde PlaneTrackingMode yapılandırılmasını gerektiriyor.
  • SpatialUser API'leri artık Session.configure() içinde HeadTrackingMode yapılandırılmasını gerektiriyor.
  • ResizableComponent eklenmediğinde HATA düzeyinde günlük yerine BİLGİ düzeyinde günlük verilir.
  • Fov sınıfı artık normal bir Kotlin sınıfıdır.
  • Her somut varlık türünü kendi dosyasına yerleştirmek için Entity.kt öğesini bölün.
  • Yeni bir PanelEntity oluştururken çoğu görünüm FrameLayout altında yeniden üst öğe olarak atanır. Bu, LayoutInspector ile Spatial Panels'in kullanılmasını kolaylaştırır.
  • Şu anda kullanılan XrExtensions örneği, uygulama hata ayıklamasına yardımcı olmak için platforma en iyi çabayı göstererek kaydedilir.

Hata Düzeltmeleri

  • MovableComponent ve AnchorPlacement içeren bir PanelEntity taşındığında oluşabilecek kilitlenmeyi önlemek için düzeltme eklendi.
  • ResizableComponent'nın onResizeStart geri çağırmasında eski boyutlar sağlaması sorunu düzeltildi.
  • JxrPlatformAdapterAxr'nın dispose() işlevi birden çok kez çağrıldığında yaşanan kilitlenme sorunu düzeltildi.

Sürüm 1.0.0-alpha03

26 Şubat 2025

androidx.xr.scenecore:scenecore:1.0.0-alpha03 ve androidx.xr.scenecore:scenecore-testing:1.0.0-alpha03 yayınlandı. 1.0.0-alpha03 sürümü bu commit'leri içerir.

Yeni Özellikler

  • Proguard sadeleştirme artık Jetpack XR kodu için destekleniyor

Hata Düzeltmeleri

  • Jetpack XR SceneCore için Proguard küçültmesini destekleyen ek düzeltmeler (I4f47e)
  • Küçültülmüş istemcilerde AbstractMethodError sorununu önlemek için güncellenmiş Jetpack XR Scenecore ProGuard kuralı. (I91a01)

Sürüm 1.0.0-alpha02

12 Şubat 2025

androidx.xr.scenecore:scenecore:1.0.0-alpha02 ve androidx.xr.scenecore:scenecore-testing:1.0.0-alpha02 yayınlandı. 1.0.0-alpha02 sürümü bu commit'leri içerir.

1.0.0-alpha02 sürümünden önce oluşturulan uygulamaları etkileyecek önemli değişiklik

  • Fabrika yöntemleri, Session sınıfından her bir ilgili türdeki yardımcı yönteme taşındı:
    • Session.createActivityPanelEntity(Dimensions, String, Activity, Pose) silindi ve ActivityPanelEntity.create(Session, Dimensions, String, Pose) ile değiştirildi
    • Session.createAnchorEntity(Anchor) silindi ve AnchorEntity.create(Session, Anchor) ile değiştirildi
    • Session.createAnchorEntity(Dimensions, Int, Int, Duration) silindi ve AnchorEntity.create(Session, Dimensions, Int, Int, Duration) ile değiştirildi
    • Session.createEntity(String, Pose) silindi ve ContentlessEntity.create(Session, String, Pose) ile değiştirildi
    • Session.createExrImageResource(String) silindi ve ExrImage.create(Session, String) ile değiştirildi
    • Session.createGltfEntity(GltfModel, Pose) silindi ve GltfModelEntity.create(Session, GltfModel, Pose) ile değiştirildi
    • Session.createGltfModelResource(String) silindi ve GltfModel.create(Session, String) ile değiştirildi
    • Session.createInteractableComponent(Executor, InputEventListener) silindi ve InteractableComponent.create(Session, Executor, InputEventListener) ile değiştirildi
    • Session.createMovableComponent(Boolean, Boolean, Set<AnchorPlacement>, Boolean) silindi ve MovableComponent.create(Session, Boolean, Boolean, Set<AnchorPlacement>, Boolean) ile değiştirildi
    • Session.createPanelEntity(View, Dimensions, Dimensions, String, Pose) silindi ve PanelEntity.create(Session, View, Dimensions, Dimensions, String, Pose) ile değiştirildi
    • Session.createResizableComponent(Dimensions, Dimensions) silindi ve ResizableComponent.create(Session, Dimensions, Dimensions) ile değiştirildi
    • Session.createStereoSurfaceEntity(Int, Dimensions, Pose) silindi ve StereoSurface.create(Session, Int, Dimensions, Pose) ile değiştirildi
  • Aşağıdaki desteği sonlandırılan yöntemler kaldırıldı:
    • Session.canEmbedActivityPanel(Activity) silindi. Bunun yerine getSpatialCapabilities.hasCapabilility(SPATIAL_CAPABILITY_EMBED_ACTIVITY) politikasını kullanın.
    • Session.hasSpatialCapability(Int) silindi. getSpatialCapabilities(), SpatialCapabilities nesnesi döndürdüğünden, getSpatialCapabilities().hasCapability()'nın uzamsal özelliklerin varlığını kontrol etmek için daha bölümlere ayrılmış bir yöntem olarak kullanılması tercih edilerek bu yöntem değiştirildi.
    • Session.requestFullSpaceMode() silindi ve SpatialEnvironment.requestFullSpaceMode() ile değiştirildi
    • Session.requestHomeSpaceMode() silindi ve SpatialEnvironment.requestHomeSpaceMode() ile değiştirildi
  • Session.setFullSpaceMode(Bundle) ve Session.setFullSpaceModeWithEnvironmentInherited(Bundle), uzantı işlevlerine taşındı. Geliştirici dosyalarının erişim için yeni içe aktarmaları eklemesi gerekir:
    • import androidx.xr.scenecore.setFullSpaceMode
    • import androidx.xr.scenecore.setFullSpaceModeWithEnvironmentInherited
  • Session.setPreferredAspectRatio(Activity, Float), uzantı işlevine taşındı. Geliştirici dosyalarının erişim için yeni içe aktarma işlemini eklemesi gerekir:
    • import androidx.xr.scenecore.setPreferredAspectRatio
  • Session.getEntitiesOfType(Class<out T>) ve Session.getEntityForRtEntity(RtEntity), uzantı işlevlerine taşındı. Geliştirici dosyalarının erişim için yeni içe aktarmaları eklemesi gerekir:
    • import androidx.xr.scenecore.getEntitiesOfType
    • import androidx.xr.scenecore.getEntityForRtEntity
  • Session.unpersistAnchor(Anchor) silindi
  • Session.createPersistedAnchorEntity(UUID) silindi

Bilinen sorunlar

  • PanelEntity.setCornerRadius() ve ActivityPanelEntity.setCornerRadius(), panel bir sonraki taşıma işlemine kadar geçerli olmayabilir. Bu durum, paneli mevcut konumuna taşıyarak giderilebilir.
  • BoundsChanged, ActivitySpace cihazında arandığında bazı ActivityPose'ler doğru şekilde güncellenmemiş olabilir. ActivitySpace tarihinde yapılacak OnSpaceUpdated görüşmesinde güncellenecek.

Kırılma ve davranış değişiklikleri

  • Panelin genişliği veya yüksekliği 32 dp'den küçükse PanelEntity ve ActivityPanelEntity için varsayılan köşe yarıçapı 32 dp veya daha küçük olur.

Yeni API'ler ve özellikler

  • StereoSurface.CanvasShape özelliğini kullanıma sunar. Bu özellik, etkileyici medya oluşturmak için Spherical ve Hemispherical tuvallerinin oluşturulmasına olanak tanır.
  • StereoSurfaceEntity.create() artık CanvasShape parametresini kabul ediyor. (Bu parametre şu anda yoksayılmaktadır ancak gelecekteki bir sürümde kullanılacaktır.)
  • StereoSurfaceEntity.create() artık Dimensions parametresini kullanmıyor. Uygulamalar, CanvasShape ayarını yaparak tuvalin boyutunu kontrol etmelidir.
  • StereoSurfaceEntity, dinamik olarak ayarlanabilen CanvasShape üyesine sahiptir.
  • StereoSurfaceEntity.dimensions artık salt okunur bir özelliktir. Uygulamalar, boyutları değiştirmek için CanvasShape değerini ayarlamalıdır.
  • StereoSurfaceEntity artık StereoMode'ın yapılandırmadan sonra yeniden ayarlanmasına izin veriyor.

Diğer değişiklikler

  • Derleme zamanı minSDK 24'e düşürüldü. Tüm Jetpack XR API'leri, çalışma zamanında API 34 gerektirmeye devam eder.
  • SceneCore'nın oturum fabrikası (Session.create) artık SCENE_UNDERSTANDING iznini almak için bir amaç başlatmıyor. Bunun yerine, istemci uygulaması, bağlantı oluşturmaya çalışmadan önce izinleri kullanıcıdan açıkça istemelidir. Kullanıcı izin vermezse bağlantı oluşturma işlemi başarısız olur.

Hata düzeltmeleri

  • getActivitySpacePose(), her zaman ölçeklendirilmemiş metreler yerine çeviri değerlerini ölçeklendirilmiş metreler olarak döndürerek ActivitySpace ölçeğini hesaba katacak şekilde düzeltildi. transformPoseTo artık kaynak veya hedefte ActivitySpace olduğunda koordinat değişikliklerini hesaplamak için doğru birimleri de kullanıyor.
  • Artık setSpatialEnvironmentPreference(new SpatialEnvironmentPreference(null, geom)) kullanılarak boş bir gökyüzü kutusu tercihi iletildiğinde gökyüzü kutusu tamamen siyah bir gökyüzü kutusu olarak ayarlanacak. Sistemin varsayılan gökyüzü kutusuna ve geometrisine geri dönmek için setSpatialEnvironmentPreference(null). kullanın.

Sürüm 1.0.0-alpha01

12 Aralık 2024

androidx.xr.scenecore:scenecore-* 1.0.0-alpha01 iptal edilir.

İlk Sürümün Özellikleri Etkileyici sahneler ve ortamlar oluşturup bunları düzenlemek için kullanılan 3D sahne grafiği kitaplığı Jetpack SceneCore'un ilk geliştirici sürümü. Bu kitaplık, 3D modelleri ve içerik panellerini birbirlerine ve sanal ya da gerçek dünya ortamlarınıza göre yerleştirip düzenlemenize olanak tanır.

  • SpatialEnvironment: XR sahnenizin arka planı olarak gökyüzü resmi ve/veya 3D model geometrisiyle tamamen sürükleyici deneyimler oluşturun. Alternatif olarak, sanal sahnenizin kullanıcının gerçek dünya ortamıyla entegre olabilmesi için geçişi etkinleştirin.
  • PanelEntity: Standart Android düzenlerini ve Etkinliklerini, gerçek dünyadaki yüzeylere sabitlenebilen veya yüzeylerde kaydırılabilen, uzamsallaştırılmış panellere yerleştirerek 3D sahnelerinize 2D içerik ekleyin.
  • GltfModelEntity: Sahnenizdeki 3D modelleri yerleştirin, canlandırın ve bunlarla etkileşimde bulunun. SceneCore, mevcut modellerle kolay entegrasyon için glTF dosya biçimini destekler.
  • SpatialAudio: Tamamen etkileyici ve uzamsallaştırılmış ses için 3D sahnenize ortam ve nokta ses kaynakları ekleyin.
  • StereoSurfaceEntity: SceneCore, Android Surface'e işlenen içeriğin sol/sağ göz yönlendirmesini destekler. Bu, yan yana veya üst-alt biçiminde stereoskopik içerik oluşturmak için kullanılabilir. Örneğin, stereo fotoğraflar, 3D video veya dinamik olarak oluşturulan diğer kullanıcı arayüzleri. Uygulamalar, video kod çözme için MediaPlayer veya ExoPlayer'ı kullanmalıdır.
  • Bileşen sistemi: SceneCore, kullanıcıların modeller ve panellerle hareket etme, yeniden boyutlandırma ve etkileşim kurma gibi olanaklar da dahil olmak üzere XR içeriğinize özellikler eklemek için güçlü ve esnek bir bileşen sistemi sunar.
  • Sabitleme: Geçiş etkinleştirildiğinde panelleri ve modelleri gerçek yüzeylere ekleyebilir, böylece kullanıcılara sanal içeriğin gerçek dünya ortamlarına sorunsuz bir şekilde entegrasyonunu sağlayabilirsiniz.
  • Kullanıcı Pozu: İçeriğinizi kullanıcının konumuna göre yönlendirmek için sanal sahnedeki kullanıcının konumuna erişin.
  • SpatialCapabilities: Kullanılabilir olduğunda, kullanıcı arayüzü içeriğinin 3D konumlandırılması gibi uzamsallaştırılmış özelliklerden yararlanan, tamamen uyarlanabilir uygulamalar oluşturun. Bununla da kalmayıp uygulamanız, kullanıcıların Android XR cihazlarını kullanma şekillerine göre deneyimi değiştirmek için uygulama yürütülürken özelliklerdeki değişiklikleri izleyebilir.

Bilinen Sorunlar

  • Jetpack SceneCore'u kullanmak için şu anda 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"/> ekleyin.
  • Oturum, ana paneli yeniden boyutlandırma, çevre birimleri bağlama ve açık ile koyu mod arasında geçiş yapma gibi Etkinliğin otomatik olarak yeniden oluşturulduğu çeşitli durumlarda geçersiz hale gelebilir. Oturum geçersiz kılma sorunlarıyla karşılaşırsanız geçici çözümler arasında ana panelinizi yeniden boyutlandırılamaz hale getirme, dinamik panel öğesi kullanma, belirli yapılandırma değişiklikleri için etkinlik yeniden oluşturmayı devre dışı bırakma veya açık/koyu mod tema değişikliklerini devre dışı bırakma yer alır.
  • Taşınabilir ve yeniden boyutlandırılabilir bileşenler GltfEntity'de desteklenmez.
  • Entity.getSize(), GltfEntity'de desteklenmez.
  • Jetpack XR uygulamalarının AndroidManifest'te android.permission.SCENE_UNDERSTANDING izni istemesi gerekir.
  • Oturum oluşturma yalnızca Android XR cihazlarda desteklenir. Şu anda bir oturum oluşturup Android XR olmayan bir cihazda kullanmaya çalışırsanız RuntimeException alırsınız.
  • `SpatialEnvironment.setSpatialEnvironmentPreference()` aracılığıyla gökyüzü kutusunun null olarak ayarlanması, belgelendiği gibi tamamen siyah bir gökyüzü kutusuyla sonuçlanmıyor. Bu durumda, sistemin varsayılan gökyüzü kutusu gösterilebilir veya mevcut gökyüzü kutusunda değişiklik yapılmayabilir.
  • SceneCore istemcileri, uygulamalarının bağımlılıkları için Gradle yapılandırmalarına implementation(“com.google.guava:listenablefuture-1.0”) eklemelidir. Scenecore, gelecekteki bir sürümde bu kitaplığı api bağımlılık olarak içerecek. Böylece istemcilerin bunu açıkça bildirmesi gerekmeyecek.
  • SceneCore, com.google.guava:guava-31.1-android ve com.google.protobuf:protobuf-javalite öğelerini yanlışlıkla geçişli bağımlılık olarak içeriyor. Bu durum, derlemenizde yinelenen sınıf hatalarına neden olursa bu iki bağımlılık güvenli bir şekilde hariç tutulabilir.
  • Uygulamanız SceneCore kullanıyor ve ProGuard'ı etkinleştiriyorsa oturum oluşturduğunuzda uygulama çöker. Geçici çözüm olarak ProGuard'ı devre dışı bırakın. ProGuard'ı etkinleştirme hakkında daha fazla bilgi için bu kılavuza bakın.