‫Jetpack SceneCore

تحديد الاعتماديات

لإضافة اعتمادية على XR SceneCore، يجب تضمين مستودع Google Maven في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

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

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

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

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

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

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

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات البناء.

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 1.0

الإصدار 1.0.0-alpha09

‫19 نوفمبر 2025

تم طرح androidx.xr.scenecore:scenecore-*:1.0.0-alpha09. يتضمّن الإصدار 1.0.0-alpha09 هذه التعديلات.

الميزات الجديدة

• تضيف هذه السمة واجهة برمجة تطبيقات لاسترداد ScenePose يمثّل تركيبة وضعية مصدر مساحة الإدراك ووضعية بالنسبة إلى مصدر مساحة الإدراك. (I5b50a)
• تمت إضافة الدالة getGravityAlignedPose. يتجاهل الوضع المحاذي للجاذبية زاوية الميل وزاوية الدوران. (I5ae21)
• تم تغيير أنواع الثوابت AnchorEntity.State من أعداد صحيحة إلى أنواع فرعية للحالة. (Ib0c49)
• تمت إضافة getChildren() إلى واجهة Entity. تم تعديل مراحل النشاط في MainPanelEntity. (Ia69d6)

تغييرات واجهة برمجة التطبيقات

• تم تغيير أنواع الثوابت PointerCaptureComponent.PointerCaptureState من Ints إلى الأنواع الفرعية PointerCaptureState. (Ic888a)
• أصبح Scene.spatialCapabilities الآن من النوع Set<SpatialCapability> بدلاً من حقل Int. تمت إعادة تسمية الثوابت SpatialCapability. (I9c109)
• تمت إعادة تسمية أنواع الثوابت SurfaceEntity وتغييرها من أعداد صحيحة إلى أنواع فرعية من SurfaceEntity. (I419ed)
• تمت إعادة تسمية أنواع الثوابت SpatializerConstant وتغييرها من أعداد صحيحة إلى أنواع فرعية من SpatializerConstant. (Ia0e18)
• تمت إعادة تسمية أنواع الثوابت TextureSampler وتغييرها من أعداد صحيحة إلى أنواع فرعية من TextureSampler. (I44078)
• تم تغيير أنواع الثوابت SpatialVisibility من Ints إلى الأنواع الفرعية SpatialVisibility. (I70739)
• تمت إعادة تسمية أنواع الثوابت ResizeEvent.ResizeState وتغييرها من أعداد صحيحة إلى أنواع فرعية من ResizeState. (I384d5)
• تمت إعادة تسمية أنواع الثوابت InputEvent وتغييرها من Ints إلى أنواع موروثة من النوع المحيط بكل منها. (I82817)
• تم تغيير أنواع الثوابت GltfModelEntity.AnimationState من Ints إلى الأنواع الفرعية AnimationState. (I24f4e)
• تمت إعادة تسمية أنواع الثوابت AlphaMode وتغييرها من أعداد صحيحة إلى أنواع فرعية من AlphaMode. (I27b56)
• تم تغيير أنواع الثوابت Space من أعداد صحيحة إلى أنواع فرعية من المساحة. (I9255b)
• تعرِض الدالة ScenePose.hitTest والطُرق ذات الصلة الآن null إذا لم يتم العثور على أي تقاطع، بدلاً من HitTestResult مع قيمة فارغة hitPosition. لم يعُد بإمكانك ضبط قيمة HitTestResult.hitPosition على Null. (I1400a)
• تم تغيير مراجع ActivityPose إلى ScenePose. (I7fe43)

الإصدار 1.0.0-alpha08

‫22 أكتوبر 2025

تم طرح androidx.xr.scenecore:scenecore-*:1.0.0-alpha08. يتضمّن الإصدار 1.0.0-alpha08 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• تمت إعادة تسمية ActivityPanelEntity.moveActivity إلى transferActivity (I273c5، b/430332856)

إصلاح الأخطاء

• تمت إضافة :xr:scenecore:scenecore-spatial-rendering و:xr:scenecore:scenecore-spatial-core كمتطلبات تنفيذ :xr:scenecore:scenecore (I6ab65، b/447000520)
• يتم عرض استثناء إذا تم الوصول إلى session.scene بعد إيقاف الجلسة. (I77e6f)

الإصدار 1.0.0-alpha07

‫24 سبتمبر 2025

تم إصدار androidx.xr.scenecore:scenecore:1.0.0-alpha07 وandroidx.xr.scenecore:scenecore-guava:1.0.0-alpha07 وandroidx.xr.scenecore:scenecore-testing:1.0.0-alpha07. يتضمّن الإصدار 1.0.0-alpha07 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• تمت إعادة تسمية fixedAspectRatio إلى isFixedAspectRatioEnabled وتم تحويلها إلى سمة منطقية (I5c4e8، b/440588971)
• أصبحت الفئات الوهمية Scenecore متوفّرة الآن في الوحدة xr:scenecore:scenecore-testing. (Idd951)
• تمت إعادة تسمية shouldAutoHideContent إلى isAutoHideContentWhileResizingEnabled وshouldAlwaysShowOverlay إلى isAlwaysShowOverlayEnabled (I97c36، b/432335421)
• تم تعديل الثوابت SceneCore TextureSampler لتسهيل قراءتها، مثلاً أصبح TextureSampler.MinFilter.LINEAR الآن TextureSampler.MIN_FILTER_LINEAR (Ib159c)
• تم دمج أداة ضبط setKeyEntity الخاصة بالمشهد في المتغيّر keyEntity. سيؤدي ضبط keyEntity على عنصر Entity غير قابل للنقل، مثل AnchorEntity، إلى عرض IllegalArgumentException بدلاً من عرض القيمة المنطقية "خطأ". (I62080، b/428721695، b/422215745)
• تم استبدال المتغيّر SpatialModeChangeListener الخاص بالمشهد بـ setSpatialModeChangedListener. تتلقّى هذه الدالة قيمة Consumer<SpatialModeChangeEvent> بدلاً من SpatialModeChangedListener. يمكن أن تقبل الدالة setSpatialModeChangedListener الآن بشكل اختياري وسيطًا من النوع Executor. (I62080، b/428721695، b/422215745)
• تمت إزالة المَعلمة bundle من ActivityPanelEntity.startActivity (I64344، b/430332856، b/430333040)
• تمت إعادة تسمية SpatializerConstants.SOURCE_TYPE_BYPASS إلى SpatializerConstants.SOURCE_TYPE_DEFAULT. (Ifc7fe، b/422215565)
• تمت إضافة الثابت SpatialSoundPool.PLAY_FAILED. (Ifc7fe، b/422215565)
• تمت إضافة وسيطات تلقائية إلى طرق SpatialSoundPool.play. (Ifc7fe، b/422215565)
• تمت إزالة قيمة الإرجاع الخاصة بالدوال الضابطة في SpatialAudioTrackBuilder. (Ifc7fe، b/422215565)
• التغييرات في SurfaceEntity
  • تمت إعادة تسمية SurfaceEntity.CanvasShape إلى Shape
  • تمت إعادة تسمية SurfaceEntity.CanvasShape.Vr180Hemisphere إلى Hemisphere
  • تمت إعادة تسمية SurfaceEntity.CanvasShape.Vr360Sphere إلى Sphere
  • تمت إعادة تسمية SurfaceEntity.EdgeFeatheringParams.SmoothFeather إلى RectangleFeather
  • تمت إعادة تسمية SurfaceEntity.EdgeFeathingParams.SolidEdge إلى NoFeathering
  • تمت إعادة تسمية SurfaceEntity.ContentSecurityLevel إلى SurfaceProtection
  • أضاف SurfaceEntity.ContentSecurityLevel.{values} البادئة SURFACE_PROTECTION_.
  • أضاف SurfaceEntity.SuperSampling.{$values} بادئة SUPER_SAMPLING_
  • أضاف SurfaceEntity.StereoMode.{values} بادئة STEREO_MODE_
  • تمت إعادة تسمية SurfaceEntity.ContentColorMetadata.maxCLLmaxContentLightLevel (I7eb5f وb/422216050 وb/427529950)
• تمت إعادة تسمية launchActivity إلى startActivity (I7db90، b/430332856)
• تمت إزالة Scene.activitySpaceRoot. يمكنك استخدام Scene.activitySpace كبديل. (I05ee8، b/378706624، b/422215745)
• تمت إعادة تسمية configureBundleForFullSpaceModeLaunch وconfigureBundleForFullSpaceModeLaunchWithEnvironmentInherited إلى createBundleForFullSpaceModeLaunch وcreateBundleForFullSpaceModeLaunchWithEnvironmentInherited على التوالي، وتم نقلهما إلى ملف LaunchUtils.kt كطُرق من المستوى الأعلى، كما تم ضبطهما على أخذ Session كمعلَمة أولى (I64a2c، b/437186050)
• يعرض المصنع GroupEntity الآن النوع GroupEntity بدلاً من Entity. (I66042)

إصلاح الأخطاء

• طرح IllegalStateException عند استخدام مثيل كيان بعد التخلص منه (I90990، b/427314036، b/432063442)

الإصدار 1.0.0-alpha06

‫13 أغسطس 2025

تم إصدار androidx.xr.scenecore:scenecore:1.0.0-alpha06 وandroidx.xr.scenecore:scenecore-guava:1.0.0-alpha06 وandroidx.xr.scenecore:scenecore-testing:1.0.0-alpha06. يتضمّن الإصدار 1.0.0-alpha06 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

• إلغاء حظر واجهات برمجة التطبيقات SceneCore وBaseEntity وBaseScenePose (88c0ff6)

الإصدار 1.0.0-alpha05

‫30 يوليو 2025

تم إصدار androidx.xr.scenecore:scenecore-guava:1.0.0-alpha05 وandroidx.xr.scenecore:scenecore-testing:1.0.0-alpha05 وandroidx.xr.scenecore:scenecore:1.0.0-alpha05. يتضمّن الإصدار 1.0.0-alpha05 هذه التعديلات.

الميزات الجديدة

• تمت إضافة واجهة برمجة التطبيقات "الدقة المدرَكة" إلى "كيانات اللوحة" وSurfaceEntities. (I118f6)
• تمت إضافة طرق معاودة الاتصال PerceivedResolution إلى Scene.kt لمراقبة الدقة المدرَكة للّوحة الرئيسية للنشاط في "خدمة إدارة تجربة النظام" (HSM). (I58084)
• SurfaceEntity - تمت إضافة دعم للتطبيق لطلب أخذ عينات فائقة عند الإنشاء. يتيح ذلك للتطبيقات استخدام فلتر أخذ العينات الفائق لتنعيم الحواف. (I06913)
• تمت إضافة الموقع recommendedContentBoxInFullSpace إلى الحساب ActivitySpace. تعرض هذه السمة مربّعًا مقترَحًا لوضع المحتوى فيه عند تفعيل "وضع المساحة الكاملة". (I4cd6f)
• تم توفير أداة إنشاء محمّلة بشكل زائد للمعدِّل القابل للنقل الذي يتيح التثبيت. (Ic0c70)

تغييرات واجهة برمجة التطبيقات

تم إجراء تغييرات شاملة على واجهة برمجة التطبيقات SceneCore في هذا الإصدار. تمت إعادة تسمية العديد من الفئات و/أو نقلها إلى وحدات مختلفة، وتم استبدال معظم طرق getter/setter بخصائص Kotlin. مع أنّنا نتوقّع إجراء تغييرات غير متوافقة في واجهة برمجة التطبيقات في المستقبل إلى أن يتم إصدار الإصدار التجريبي الأول، لن تكون هذه التغييرات مزعجة أو عديدة.

• تمت إعادة تسمية و/أو نقل الفئات والواجهات التالية: 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 بشكل خاص، ولم يكن من المفترض أن يتم تغييرها من خلال عملاء SceneCore: activitySpace وactivitySpaceRoot وmainPanelEntity وperceptionSpace وspatialCapabilities وspatialEnvironment وspatialUser. (I2f506)
• في الكيان: تم تغيير ما يلي إلى سمات: get/setParent() وsetContentDescription. تم إيقاف Entity.is/setHidden() نهائيًا، يُرجى استخدام Entity.is/setEnabled بدلاً من ذلك. (Ibc4c6)
• تمت إزالة الفئة androidx.xr.scenecore.BasePanelEntity، يُرجى استخدام PanelEntity مباشرةً بدلاً منها. تم استبدال دوال الحصول على البيانات وتعيينها لـ PanelEntity بالخصائص. تم تغيير السمة PanelEntity.size من Float3dSize إلى Float2dSize. تمت إزالة الطريقة المتوقّفة نهائيًا androidx.xr.scenecore.PanelEntity.getPixelDimensions، يُرجى استخدام getSizeInPixels بدلاً منها. (Icc174)
• تم استبدال androidx.xr.scenecore.OnSpaceUpdatedListener بـ Runnable. (I19308)
• تم استبدال SpatialUser.getCameraViews() بسمة. (Ib0cc5) بالنسبة إلى ExrImage وGltfModel:، تم تغيير طرق create لتصبح وظائف معلّقة، وتم تعديل مَعلمات الإنشاء لقبول Uri أو Path بدلاً من String. (Id8883) (I0d247)، (I25706)
• تم نقل SpatialEnvironment.requestFullSpaceMode وSpatialEnvironment.requestHomeSpaceMode إلى "المشهد"، مثلاً استخدِم session.scene.requestFullSpaceMode() بدلاً من session.scene.spatialEnvironment.requestFullSpaceMode(). يتضمّن كل من addOnPassthroughOpacityChangedListener وaddOnSpatialEnvironmentChangedListener الآن عمليات إلغاء تقبل المنفّذين الاختياريين. (I12fe0) (I6b21e)
• تمت إزالة طرق SpatialEnvironment المتوقّفة نهائيًا التالية: togglePassthrough وsetPassthrough وsetPassthroughOpacity وgetPassthroughMode وgetPassthroughOpacity وsetSkybox وsetGeometry. تمت أيضًا إزالة الفئة المتوقّفة نهائيًا SpatialEnvironment.PassthroughMode (I927bd) (I927bd) (I927bd)
• تم استبدال دوال الجلب والضبط التالية SpatialEnvironment بخصائص Kotlin: getCurrentPassthroughOpacity() وget/setPassthroughOpacityPreference() وget/setSpatialEnvironmentPreference() وisSpatialEnvironmentPreferenceActive() (I33a7b) (Ie06e2) (Ie06e2)
• تم تغيير نوع SpatialEnvironmentPreference.preferredPassthroughOpacity من Float? إلى Float. لم يعُد يقبل القيم الفارغة. بدلاً من ذلك، يتم استخدام SpatialEnvironment.NO_PASSTHROUGH_OPACITY_PREFERENCE للإشارة إلى عدم توفّر أي إعدادات مفضّلة للشفافية. (I40107)
• تم تعديل المَعلمة windowBoundsPx إلى pixelDimensions وتغيير نوعها من Rect إلى IntSize2d في طريقة الإنشاء. (I1926e)
• أصبح منشئ SpatialEnvironment داخليًا الآن (I75a51)
• تم استبدال الفئتين SpatialPointerIconNone وSpatialPointerIconCircle بالكائنين المصاحبين SpatialPointerIcon.NONE وSpatialPointerIcon.CIRCLE (I416d2)
• لم يعُد الحقل SpatialPointerIcon في SpatialPointerComponent يقبل القيمة الخالية. استخدِم SpatialPointerIcon.DEFAULT بدلاً من القيمة الخالية للإشارة إلى أنّه يجب استخدام رمز المؤشر التلقائي للنظام. (I416d2)
• تم استبدال androidx.xr.scenecore.AnchorEntity.getState() بسمة للقراءة فقط. تمت إعادة تسمية المَعلمات في الطريقة AnchorEntity.create() لتوضيحها. في طرق AnchorEntity لإعداد المستمعين وإضافتهم، تم نقل المستمع إلى الوسيطة النهائية لتفعيل lambdas اللاحقة. تم استبدال androidx.xr.scenecore.OnStateChangedListener بـ AnchorEntity بـ Consumer<AnchorEntity.State>. (I472e0)
• أصبح GltfModelEntity.getAnimationState() الآن موقعًا. (I10b29)
• تم استبدال ActivitySpace.getBounds() بسمة. تمت إعادة تسمية ActivitySpace.addBoundsChangedListener إلى ActivitySpace.addOnBoundsChangedListener. تم استبدال ActivitySpace.setOnSpaceUpdatedListener بطرق الإضافة/الإزالة. (I4c956)
• تمت إعادة تسمية AnchorPlacement: planeTypeFilter إلى anchorablePlaneOrientations، وتمت إعادة تسمية planeSemanticFilter إلى anchorablePlaneSemanticTypes. ستؤدي إضافة MovableComponent إلى AnchorEntity أو ActivitySpace إلى عرض القيمة false، وتمت إعادة تسمية MoveListener إلى EntityMoveListener shouldDisposeParentAnchor، ثم إلى disposeParentOnReAnchor systemMovable، وتمت إزالتها من الدالة create لصالح creeateCustomMovable وcreateSystemMovable وcreateAnchorable (If11c4)
• تمت إزالة SurfaceEntity.featherRadiusX/Y وإضافة مفهوم الصف EdgeFeatheringParams. (Ic78fc)
• تم استبدال الطريقة PanelEntity.enablePanelDepthTest() بالسمة panelClippingConfig. اضبط Scene.panelClippingConfig = PanelClippingConfig(isDepthTestEnabled = true) لتفعيل اختبار العمق أو اضبطه على PanelClippingConfig(isDepthTestEnabled = false) لإيقافه. (I0cbe0)
• أصبح نوع Scene.mainPanelEntity الآن MainPanelEntity بدلاً من PanelEntity (I7125a)
• تمت إعادة تسمية طريقة setFullSpaceMode في Scene إلى configureBundleForFullSpaceModeLaunch وطريقة setFullSpaceModeWithEnvironmentInherited إلى configureBundleForFullSpaceModeLaunchWithEnvironmentInherited. (I0cbe0) (I0cbe0)
• تمت إعادة تسمية القيم UNKNOWN وOUTSIDE_FOV وPARTIALLY_WITHIN_FOV وWITHIN_FOV في SpatialVisibility إلى SPATIAL_VISIBILITY_UNKNOWN وSPATIAL_VISIBILITY_OUTSIDE_FIELD_OF_VIEW وSPATIAL_VISIBILITY_PARTIALLY_WITHIN_FIELD_OF_VIEW وSPATIAL_VISIBILITY_WITHIN_FIELD_OF_VIEW على التوالي (Ie7e8c)
• تم استبدال الفئة SpatialVisibility بكائن عام يتضمّن قيم Int ثابتة. تقبل setSpatialVisibilityChangedListener الآن Consumer<Int> بدلاً من Consumer<SpatialVisibility> (Ie7e8c)
• تمت إعادة تسمية الثوابت PointerCaptureComponent ونقلها إلى العنصر PointerCaptureComponent.PointerCaptureState (I9c7ac)
• تم استبدال PointerCaptureComponents' StateListener بـ Consumer<Int>. (I9c7ac)
• تمّ استبدال InputEventListener بـ Consumer<InputEvent> (I9c7ac)
• تم نقل setPreferredAspectRatio من فئة Scene إلى عنصر SpatialWindow، ويتم إدخال Session كمعلَمة أولى. (I7b717)
• تم استبدال Entity.setHidden() بـ Entity.setEnabled()، وتم استبدال Entity.isHidden() بـ Entity.isEnabled(). setHidden(false) تساوي setEnabled(true) وisHidden() == !isEnabled(). (Icf0de)
• تم تغيير نوع Entity.contentDescription من "سلسلة" إلى CharSequence. (Ie59be)
• تعرض الدالتان Session.create وSession.configure الآن الخطأ SecurityException عند عدم منح أذونات كافية بدلاً من عرض SessionCreatePermissionsNotGranted أو SessionConfigurePermissionsNotGranted. (I7c488)
• يتطلّب ResizableComponent.create الآن Consumer<ResizeEvent> ResizeEventListener تم استبداله بـ Consumer<ResizeEvent> ResizableComponent.size تمت إعادة تسميته إلى ResizableComponent.affordanceSize ResizableComponent.minimumSize تمت إعادة تسميته إلى ResizableComponent.minimumEntitySize ResizableComponent.maximumSize تمت إعادة تسميته إلى ResizableComponent.maximumEntitySize، تمت إعادة تسمية ResizableComponent.autoHideContent إلى ResizableComponent.shouldAutoHideContent تمت إعادة تسمية ResizableComponent.forceShowResizeOverlay إلى ResizableComponent.shouldAlwaysShowOverlay (I97a2d)
• تم خفض minSDK إلى 24 لكل من androidx.xr.scenecore وandroidx.xr.compose. ستظل حِزم XR تتطلّب استخدام المستوى 34 لواجهة برمجة التطبيقات في وقت التشغيل. (I17224)
• تمت إزالة القيود المفروضة على RequiresApi(34) في جميع حِزم Jetpack XR. كان هذا القيد غير ضروري لأنّ Jetpack XR لا يتوفّر حاليًا إلا على الأجهزة التي تعمل بالإصدار 34 من واجهة برمجة التطبيقات أو الإصدارات الأحدث. (Iae0f8)
• سيحتوي العنصر الرئيسي SceneCore (xr:scenecore:scenecore) على واجهات برمجة تطبيقات غير متزامنة بنمط Kotlin فقط. يمكن لمطوّري Java الاعتماد على مكتبة xr:scenecore:scenecore-guava للوصول إلى واجهات برمجة التطبيقات المتوافقة. (If221b)
• تتطلّب المشاريع التي تم إصدارها باستخدام Kotlin 2.0 استخدام الإصدار 2.0.0 أو إصدار أحدث من KGP (Idb6b5)
• تستخدم هذه المكتبة الآن تعليقات توضيحية بشأن القيم الخالية في JSpecify، وهي تعليقات توضيحية خاصة بالاستخدام. على مطوّري Kotlin استخدام وسيطة المترجم البرمجي التالية لفرض الاستخدام الصحيح: -Xjspecify-annotations=strict (هذه هي القيمة التلقائية بدءًا من الإصدار 2.1.0 من مترجم Kotlin البرمجي) (Ia8420)
• تم استبدال جميع الطرق غير المتزامنة التي تعرض ListenableFuture بدوال تعليق في Kotlin. على مطوّري Java الذين يريدون استخدام طرق غير متزامنة مستندة إلى ListenableFuture بدلاً من دوال التعليق في Kotlin استخدام دوال الإضافة في :xr:scenecore-scenecore-guava. على سبيل المثال، يحتوي GuavaExrImage على دوال ExrImage غير المتزامنة المكافئة لـ Guava، ويحتوي GuavaScenePose على دوال ScenePose غير المتزامنة المكافئة لـ Guava، ويحتوي GuavaGltfModel على دوال Guava-equivalent GltfModel غير المتزامنة، وما إلى ذلك. (If7283) (I0af60) (If7283) (Ia8515) (I4efdf) (I54bbf) (I3467a) (I82a33)

إصلاح الأخطاء

• تم تعديل قاعدة Jetpack XR Scenecore ProGuard لمنع AbstractMethodError للعملاء المصغّرين. (I91a01)
• إصلاحات إضافية لدعم تصغير Proguard في Jetpack XR SceneCore (I4f47e)
• تم إصلاح الخطأ الذي قد يتسبّب فيه InteractableComponent في حدوث عُطل إذا كان hitPosition في HitInfo الخاص بـ InputEvent قد يتعطّل إذا كانت قيمة hitPosition التي تم إرجاعها من النظام فارغة (I7a695).
• تمت إعادة تسمية قيم *الوضع في ملف الإعداد لتعكس سلوكها. (I6d247)
• تم إصلاح المشاكل المتعلّقة بمجال الرؤية وHitTest في SceneCore TestApp. (I2c51e)
• تم إصلاح الخطأ في SpatialCapabilities.hasCapability() الذي كان يعرض القيمة "صحيح" إذا كانت أي من الإمكانات التي تم تمريرها باستخدام OR على مستوى البت صحيحًا بدلاً من عرض القيمة "صحيح" فقط إذا كانت جميعها صحيحة. (I2cd40)
• تم تعديل SurfaceEntity.StereoMode.TOP_BOTTOM بحيث تظهر الخريطة العلوية للعين اليسرى والخريطة السفلية للعين اليمنى. (I4ae68)

الإصدار 1.0.0-alpha04

‫7 مايو 2025

تم طرح androidx.xr.scenecore:scenecore:1.0.0-alpha04 وandroidx.xr.scenecore:scenecore-testing:1.0.0-alpha04. يتضمّن الإصدار 1.0.0-alpha04 هذه التعديلات.

الميزات الجديدة

• ستعمل ميزة "الرجوع" الآن على عناصر اللوحة بدون أنشطة مضمّنة. لكي يعمل معالج الرجوع، عليك تحديد android:enableOnBackInvokedCallback= "true" في ملف البيان Android.
• يتيح StereoSurfaceEntity الآن تشغيل فيديوهات MV-HEVC من خلال قيمتَين جديدتَين StereoMode: MULTIVIEW_LEFT_PRIMARY وMULTIVIEW_RIGHT_PRIMARY.
• تعرض السمتان PanelEntity.setSize وPanelEntity.getSize الآن الأحجام في مساحة العنصر الأصل.
• تتلقّى Entity.setPose وEntity.getPose وEntity.setScale وEntity.getScale وEntity.setAlpha وEntity.getAlpha الآن مَعلمة جديدة relativeTo، ما يتيح الحصول على القيم وضبطها بالنسبة إلى مساحات مختلفة. القيم المسموح بها هي "المساحات الرئيسية" و"مساحات الأنشطة" و"مساحات العالم الحقيقي"، والقيمة التلقائية لهذه المَعلمة هي "المساحات الرئيسية".
• تمت إضافة طرق ملحقة لـ Spatial Visibility Callback إلى SessionExt.kt لتتبُّع وقت انتقال محتوى المشهد إلى داخل مجال رؤية المستخدم أو خارجه.
• تمت إضافة setPointSourceParams إلى SpatialAudioTrack، ما يتيح تعديل المَعلمات بعد إنشاء مسار البناء.
• تمت إضافة فئة جديدة، Scene، مع مراجع إلى واجهات برمجة التطبيقات Scenecore. سيكون المشهد متاحًا كسمة إضافية للجلسة. تم نقل الدوال داخل SessionExt إلى Scene، لذا يجب تعديل عمليات الاستيراد، مثل SessionExt.getScene(session).‫"addSpatialCapababilitiesChangedListener" ضد "SessionExt.addSpatialCapabilitiesChangedListener".
• تمت إضافة ActivityPose.hitTestAsync، ما يتيح hitTest ضد المحتوى الافتراضي.
• تمت إضافة نوع "المكوّن" الجديد SpatialPointerComponent، ما يتيح للعملاء تحديد الأيقونة المعروضة للمؤشر أو إيقاف الأيقونة. يمكن حاليًا ربط هذا المكوّن بـ PanelEntity مثيل فقط.
• نقدّم دالة PanelEntity جديدة تأخذ أبعاد اللوحة بالمتر أو بالبكسل. تمت إزالة مصنع PanelEntity القديم الذي يتلقّى مَعلمتَين من نوع Dimension للوحة.

تغييرات واجهة برمجة التطبيقات

• تمت إزالة القيود المفروضة على RequiresApi(34) في جميع حِزم Jetpack XR. كان هذا القيد غير ضروري لأنّ Jetpack XR لا يتوفّر حاليًا إلا على الأجهزة التي تعمل بالإصدار 34 من واجهة برمجة التطبيقات أو الإصدارات الأحدث. (Iae0f8)
• تتطلّب المشاريع التي تم إصدارها باستخدام Kotlin 2.0 استخدام الإصدار 2.0.0 أو إصدار أحدث من KGP (Idb6b5)
• تمت إزالة الصف PermissionHelper.
• تم إيقاف PanelEntity.getPixelDensity نهائيًا.
• تمت إزالة PanelEntity.setPixelDimensions وPanelEntity.getPixelDimension واستبدالهما بـ setSizeInPixels وgetSizeInPixels.
• تمت إزالة "Entity.getActivitySpaceAlpha". يمكن استبدالها بـ Entity.getAlpha(Space.Activity).
• تمت إزالة "Entity.getWorldSpaceScale". يمكن استبدالها بـ Entity.getScale(Space.REAL\_WORLD).
• تم حذف فئة Session في SceneCore لصالح Session في XR Runtime.
• تمت إعادة تسمية StereoSurfaceEntity إلى SurfaceEntity.
• تمت إزالة Entity.setSize وEntity.getSize، وتمت إضافة الطرق نفسها إلى PanelEntity.
• تمت إعادة تسمية PointSourceAttributes إلى PointSourceParams.
• تمت إعادة تسمية SpatializerConstants.SOURCE\_TYPE\_BYPASS إلى SpatializerConstants.SOURCE\_TYPE\_DEFAULT.
• تم تعديل العنصر PointSourceParams من إمكانية الوصول العامة إلى إمكانية الوصول الداخلية.
• يتطلّب AnchorEntity.create الآن إعداد PlaneTrackingMode في Session.configure().
• تتطلّب واجهات برمجة التطبيقات في SpatialUser الآن ضبط HeadTrackingMode في Session.configure().
• عندما لا يتم إرفاق ResizableComponent، سيتم عرض سجلّ على مستوى INFO بدلاً من سجلّ على مستوى ERROR.
• أصبح Fov class الآن فئة Kotlin عادية.
• قسِّم Entity.kt لوضع كل نوع من أنواع الكيانات الملموسة في ملف منفصل.
• عند إنشاء PanelEntity جديد، سيتم إعادة ربط معظم طرق العرض بـ FrameLayout. يسهّل ذلك استخدام LayoutInspector مع "اللوحات المكانية".
• تم الآن تسجيل مثيل XrExtensions المستخدَم حاليًا في المنصة بأفضل طريقة ممكنة للمساعدة في تصحيح أخطاء التطبيق.

إصلاح الأخطاء

• تمت إضافة إصلاح لمنع حدوث تعطُّل قد يحدث عند نقل PanelEntity يحتوي على MovableComponent وAnchorPlacement
• تم إصلاح المشكلة المتمثّلة في أنّ ResizableComponent كان يقدّم أحجامًا قديمة في معاودة الاتصال onResizeStart.
• تم إصلاح عُطل يحدث عند استدعاء dispose() في JxrPlatformAdapterAxr عدة مرات.

الإصدار 1.0.0-alpha03

‫26 فبراير 2025

تم طرح androidx.xr.scenecore:scenecore:1.0.0-alpha03 وandroidx.xr.scenecore:scenecore-testing:1.0.0-alpha03. يتضمّن الإصدار 1.0.0-alpha03 هذه التعديلات.

الميزات الجديدة

• أصبحت ميزة تصغير Proguard متاحة الآن لرمز Jetpack XR

إصلاح الأخطاء

• إصلاحات إضافية لتوفير إمكانية تصغير Proguard في Jetpack XR SceneCore (I4f47e)
• تم تعديل قاعدة Jetpack XR Scenecore ProGuard لمنع AbstractMethodError للعملاء المصغّرين. (I91a01)

الإصدار 1.0.0-alpha02

‫12 فبراير 2025

تم طرح androidx.xr.scenecore:scenecore:1.0.0-alpha02 وandroidx.xr.scenecore:scenecore-testing:1.0.0-alpha02. يتضمّن الإصدار 1.0.0-alpha02 هذه التعديلات.

تغيير مرتقب غير متوافق سيؤثر في التطبيقات التي تم إنشاؤها قبل الإصدار ‎1.0.0-alpha02

• تم نقل طرق المصنع من الفئة Session إلى طريقة مصاحبة لكل نوع من الأنواع المعنية:
  • تم حذف Session.createActivityPanelEntity(Dimensions, String, Activity, Pose) واستبداله بـ ActivityPanelEntity.create(Session, Dimensions, String, Pose)
  • تم حذف Session.createAnchorEntity(Anchor) واستبداله بـ AnchorEntity.create(Session, Anchor)
  • تم حذف Session.createAnchorEntity(Dimensions, Int, Int, Duration) واستبداله بـ AnchorEntity.create(Session, Dimensions, Int, Int, Duration)
  • تم حذف Session.createEntity(String, Pose) واستبداله بـ ContentlessEntity.create(Session, String, Pose)
  • تم حذف Session.createExrImageResource(String) واستبداله بـ ExrImage.create(Session, String)
  • تم حذف Session.createGltfEntity(GltfModel, Pose) واستبداله بـ GltfModelEntity.create(Session, GltfModel, Pose)
  • تم حذف Session.createGltfModelResource(String) واستبداله بـ GltfModel.create(Session, String)
  • تم حذف Session.createInteractableComponent(Executor, InputEventListener) واستبداله بـ InteractableComponent.create(Session, Executor, InputEventListener)
  • تم حذف Session.createMovableComponent(Boolean, Boolean, Set<AnchorPlacement>, Boolean) واستبداله بـ MovableComponent.create(Session, Boolean, Boolean, Set<AnchorPlacement>, Boolean)
  • تم حذف Session.createPanelEntity(View, Dimensions, Dimensions, String, Pose) واستبداله بـ PanelEntity.create(Session, View, Dimensions, Dimensions, String, Pose)
  • تم حذف Session.createResizableComponent(Dimensions, Dimensions) واستبداله بـ ResizableComponent.create(Session, Dimensions, Dimensions)
  • تم حذف Session.createStereoSurfaceEntity(Int, Dimensions, Pose) واستبداله بـ StereoSurface.create(Session, Int, Dimensions, Pose)
• تمت إزالة الطرق المتوقّفة نهائيًا التالية:
  • تم حذف Session.canEmbedActivityPanel(Activity). يمكنك استخدام getSpatialCapabilities.hasCapabilility(SPATIAL_CAPABILITY_EMBED_ACTIVITY) كبديل.
  • تم حذف Session.hasSpatialCapability(Int). تم استبدالها باستخدام getSpatialCapabilities().hasCapability() كطريقة أكثر تجزئة للتحقّق من توفّر إمكانات مكانية، لأنّ getSpatialCapabilities() تعرض الكائن SpatialCapabilities.
  • تم حذف Session.requestFullSpaceMode() واستبداله بـ SpatialEnvironment.requestFullSpaceMode()
  • تم حذف Session.requestHomeSpaceMode() واستبداله بـ SpatialEnvironment.requestHomeSpaceMode()
• تم نقل Session.setFullSpaceMode(Bundle) وSession.setFullSpaceModeWithEnvironmentInherited(Bundle) إلى دوال الإضافة. يجب أن تضيف ملفات المطوّر عمليات الاستيراد الجديدة للوصول إلى ما يلي:
  • import androidx.xr.scenecore.setFullSpaceMode
  • import androidx.xr.scenecore.setFullSpaceModeWithEnvironmentInherited
• تم نقل Session.setPreferredAspectRatio(Activity, Float) إلى دالة إضافة. يجب أن تضيف ملفات المطوّر عملية الاستيراد الجديدة للوصول إلى:
  • import androidx.xr.scenecore.setPreferredAspectRatio
• تم نقل Session.getEntitiesOfType(Class<out T>) وSession.getEntityForRtEntity(RtEntity) إلى دوال الإضافة. يجب أن تضيف ملفات المطوّر عمليات الاستيراد الجديدة للوصول إلى ما يلي:
  • import androidx.xr.scenecore.getEntitiesOfType
  • import androidx.xr.scenecore.getEntityForRtEntity
• تم حذف Session.unpersistAnchor(Anchor)
• تم حذف Session.createPersistedAnchorEntity(UUID)

المشاكل المعروفة

• قد لا يتم تطبيق PanelEntity.setCornerRadius() وActivityPanelEntity.setCornerRadius() إلا عند نقل اللوحة في المرة التالية، ويمكن حلّ هذه المشكلة من خلال نقل اللوحة إلى موضعها الحالي.
• عندما يتم استدعاء BoundsChanged على ActivitySpace، قد لا يتم تعديل بعض ActivityPose بشكلٍ صحيح. سيتم تعديلها في مكالمة OnSpaceUpdated التالية في ‎ActivitySpace.

التغييرات التي قد تؤدي إلى عطل والتغييرات السلوكية

• سيكون PanelEntity وActivityPanelEntity بنصف قطر تلقائي للزاوية يبلغ 32 بكسل غير مرتبط بالكثافة أو أقل إذا كان عرض اللوحة أو ارتفاعها أقل من 32 بكسل غير مرتبط بالكثافة.

واجهات برمجة التطبيقات والإمكانات الجديدة

• يقدّم StereoSurface.CanvasShape، ما يتيح إنشاء لوحات عرض Spherical وHemispherical لعرض الوسائط الغامرة.
• تقبل الدالة StereoSurfaceEntity.create() الآن المَعلمة CanvasShape. (يتم تجاهل هذه المَعلمة حاليًا، ولكن سيتم استخدامها في إصدار مستقبلي)
• لم يعُد StereoSurfaceEntity.create() يقبل المَعلمة Dimensions. يجب أن تتحكّم التطبيقات في حجم لوحة الرسم من خلال ضبط CanvasShape
• يحتوي StereoSurfaceEntity على عنصر CanvasShape يمكن ضبطه بشكل ديناميكي.
• أصبحت StereoSurfaceEntity.dimensions الآن سمة للقراءة فقط، ويجب أن تضبط التطبيقات CanvasShape لتغيير الأبعاد.
• تسمح السمة StereoSurfaceEntity الآن بإعادة ضبط StereoMode بعد الإنشاء.

التغييرات الأخرى

• تم خفض الحد الأدنى لـ minSDK في وقت التجميع إلى 24. ستظل جميع واجهات برمجة تطبيقات Jetpack XR تتطلّب المستوى 34 لواجهة برمجة التطبيقات في وقت التشغيل.
• لم يعُد مصنع الجلسات (Session.create) في SceneCore يطلق هدفًا للحصول على إذن SCENE_UNDERSTANDING. بدلاً من ذلك، يجب أن يطلب تطبيق العميل الأذونات صراحةً من المستخدم قبل محاولة إنشاء نقاط الارتكاز. ستتعذّر عملية إنشاء نقاط الارتكاز إذا لم يمنح المستخدم الإذن.

إصلاح الأخطاء

• تم إصلاح getActivitySpacePose() لاحتساب مقياس ActivitySpace من خلال عرض قيم الترجمة بالمترات التي تم تغيير مقياسها بدلاً من عرض المترات التي لم يتم تغيير مقياسها دائمًا. يستخدم transformPoseTo الآن أيضًا الوحدات الصحيحة لاحتساب تغييرات الإحداثيات عندما يكون ActivitySpace متضمّنًا في المصدر أو الوجهة.
• سيتم الآن ضبط صندوق السماء على صندوق سماء أسود بالكامل كلما تم تمرير إعداد مفضّل لصندوق سماء فارغ باستخدام setSpatialEnvironmentPreference(new SpatialEnvironmentPreference(null, geom)). للتراجع عن التغييرات والعودة إلى إعدادات النظام التلقائية الخاصة بالصندوق السماوي والأشكال الهندسية، استخدِم setSpatialEnvironmentPreference(null).

الإصدار 1.0.0-alpha01

‫12 ديسمبر 2024

تم طرح androidx.xr.scenecore:scenecore-* 1.0.0-alpha01.

ميزات الإصدار الأولي الإصدار الأولي من Jetpack SceneCore للمطوّرين، وهي مكتبة رسومات بيانية ثلاثية الأبعاد لإنشاء مشاهد وبيئات غامرة ومعالجتها. تتيح لك هذه المكتبة وضع نماذج ثلاثية الأبعاد ولوحات المحتوى وترتيبها بالنسبة إلى بعضها البعض وإلى بيئاتك الافتراضية أو الواقعية.

• SpatialEnvironment: يمكنك إنشاء تجارب غامرة بالكامل باستخدام صورة skybox و/أو هندسة نموذج ثلاثي الأبعاد كخلفية لمشهد الواقع الممتد في بيئتك. يمكنك أيضًا تفعيل ميزة "المرور" لدمج المشهد الافتراضي مع البيئة المحيطة بالمستخدم في العالم الحقيقي.
• PanelEntity: يمكنك إضافة محتوى ثنائي الأبعاد إلى مشاهدك الثلاثية الأبعاد من خلال تضمين تصميمات وأنشطة Android العادية في لوحات مكانية يمكن أن تطفو أو يتم تثبيتها على أسطح في العالم الحقيقي.
• GltfModelEntity: يمكنك وضع نماذج ثلاثية الأبعاد وتحريكها والتفاعل معها في المشهد. تتوافق SceneCore مع تنسيق ملف glTF لتسهيل عملية الدمج مع التصاميم الحالية.
• SpatialAudio: يمكنك إضافة مصادر صوتية محيطة وموضعية إلى المشهد الثلاثي الأبعاد للحصول على صوت مكاني غامر بالكامل.
• StereoSurfaceEntity: تتيح SceneCore توجيه المحتوى المعروض على مساحة عرض Android إلى العين اليسرى أو اليمنى. يمكن استخدام هذه السمة لعرض المحتوى المجسّم بتنسيق جنبًا إلى جنب أو من أعلى إلى أسفل، مثل الصور المجسّمة أو الفيديوهات الثلاثية الأبعاد أو واجهات المستخدم الأخرى التي يتم عرضها بشكل ديناميكي. يجب أن تستخدم التطبيقات MediaPlayer أو ExoPlayer لفك ترميز الفيديو.
• نظام المكوّنات: يوفّر SceneCore نظام مكوّنات قويًا ومرنًا لإضافة إمكانات إلى محتوى الواقع الممتد، بما في ذلك وسائل مساعدة للمستخدمين لنقل النماذج واللوحات وتغيير حجمها والتفاعل معها.
• نقطة الربط: عند تفعيل ميزة "المرور"، يمكنك ربط اللوحات والنماذج بالأسطح الفعلية، ما يتيح للمستخدمين دمج المحتوى الافتراضي بسلاسة في بيئتهم الواقعية.
• وضعية المستخدم: الوصول إلى الموقع الجغرافي للمستخدم في المشهد الافتراضي لتوجيه المحتوى حول موضع المستخدم
• SpatialCapabilities: يمكنك إنشاء تطبيقات قابلة للتكيّف بالكامل تستفيد من الإمكانات المكانية عند توفّرها، مثل تحديد موضع المحتوى ثلاثي الأبعاد لواجهة المستخدم. بالإضافة إلى ذلك، يمكن لتطبيقك مراقبة التغييرات في الإمكانات أثناء تنفيذه، وذلك لتعديل التجربة استنادًا إلى طريقة استخدام المستخدم لجهاز Android XR.

المشاكل المعروفة

• يجب حاليًا استخدام الإصدار 30 من minSDK لاستخدام Jetpack SceneCore. كحلّ بديل، أضِف إدخال البيان التالي <uses-sdk tools:overrideLibrary="androidx.xr.scenecore, androidx.xr.compose"/> لتتمكّن من الإنشاء والتشغيل باستخدام minSDK 23.
• يمكن أن تصبح الجلسة غير صالحة في حالات مختلفة تؤدي إلى إعادة إنشاء النشاط تلقائيًا، بما في ذلك تغيير حجم اللوحة الرئيسية وتوصيل الأجهزة الطرفية والتبديل بين الوضعين الفاتح والداكن. إذا واجهت مشاكل في إبطال الجلسة، تتضمّن الحلول البديلة عدم إمكانية تغيير حجم اللوحة الرئيسية، أو استخدام عنصر لوحة ديناميكية، أو إيقاف إعادة إنشاء النشاط لتغييرات إعدادات معيّنة، أو إيقاف تغييرات سمة الوضع الفاتح/الداكن.
• لا تتوافق المكوّنات القابلة للنقل وتغيير الحجم مع GltfEntity.
• لا يمكن استخدام Entity.getSize() في GltfEntity.
• يجب أن تطلب تطبيقات Jetpack XR الإذن android.permission.SCENE_UNDERSTANDING في ملف AndroidManifest.
• لا يمكن إنشاء جلسة إلا على جهاز Android XR. في الوقت الحالي، إذا أنشأت جلسة وحاولت استخدامها على جهاز غير Android XR، سيظهر لك الخطأ RuntimeException.
• لا يؤدي ضبط صندوق السماء على القيمة الخالية باستخدام SpatialEnvironment.setSpatialEnvironmentPreference() إلى إنشاء صندوق سماء أسود ثابت كما هو موضّح في المستندات. وقد يؤدي ذلك إلى استخدام skybox التلقائي للنظام أو عدم إجراء أي تغيير على skybox الحالي.
• على عملاء SceneCore إضافة implementation(“com.google.guava:listenablefuture-1.0”) إلى إعدادات Gradle لتبعيات التطبيق. في إصدار مستقبلي، ستتضمّن scenecore هذه المكتبة كعنصر تابع api، وبالتالي لن يحتاج العملاء إلى تعريفها بشكل صريح.
• تتضمّن SceneCore بشكل خاطئ com.google.guava:guava-31.1-android وcom.google.protobuf:protobuf-javalite كعناصر تابعة متعدية. إذا أدّى ذلك إلى حدوث أخطاء في الصفوف المكرّرة في الإصدار، يمكن استبعاد هذين العنصرَين التابعَين بأمان.
• إذا كان تطبيقك يستخدم SceneCore وفعّلت ProGuard، سيتعطّل التطبيق عند إنشاء Session. كحلّ بديل، أوقِف ProGuard. يمكنك الاطّلاع على هذا الدليل للحصول على مزيد من المعلومات حول كيفية تفعيل ProGuard.