XR Runtime

ابدأ جلسة الواقع المعزّز أو الثلاثي الأبعاد المخصّصة باستخدام وقت التشغيل الأصلي.
آخر تحديث الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأوّلي
‫7 أكتوبر 2026 - 1.0.0-rc02 - 1.1.0-alpha01

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

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

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

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.1.0-alpha01"

    // Use in environments that do not support OpenXR
    testImplementation "androidx.xr.runtime:runtime-testing:1.1.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha01")

    // Use in environments that do not support OpenXR
    testImplementation("androidx.xr.runtime:runtime-testing:1.1.0-alpha01")
}

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

الملاحظات

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

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

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

وقت التشغيل

الإصدار 1.0

الإصدار ‎1.0.0-rc02

‫7 أكتوبر 2026

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

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

  • تم إصلاح مشاكل مختلفة في androidx.xr.runtime وandroidx.xr.scenecore لتحسين أمان الذاكرة وإدارة مراحل نشاط الموارد. ويشمل ذلك تعديلات على منطق معالجة السياق وتنظيف المراجع لمنع تسرُّب الذاكرة. (Id61f8)

الإصدار 1.1

الإصدار ‎1.1.0-alpha01

‫9 سبتمبر 2026

تم طرح androidx.xr.runtime:runtime-*:1.1.0-alpha01. يتضمّن الإصدار 1.1.0-alpha01 هذه التعديلات.

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

  • إضافة SPATIAL_API_V4 إلى SpatialApiVersions (I71e7a)

الإصدار 1.0

الإصدار ‎1.0.0-rc01

‫9 سبتمبر 2026

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

التغييرات في السلوك

  • تحسين معالجة أحداث مراحل النشاط الداخلية (I2f7b8 وIf1bc3 وIfa75e)

الإصدار ‎1.0.0-beta02

‫12 أغسطس 2026

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

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

  • تم تحسين رصد OpenXR في البيئات المحاكية. (Ifec51)
  • تم تنفيذ toString() في المزيد من الفئات لتصحيح الأخطاء. (I67d83)
  • إصلاح الخطأ XrDeviceTestRule الذي يحدث عند إنشاء XrDevice بعد تطبيق الإعدادات (Ica32c)

الإصدار 1.0.0-beta01

‫15 يوليو 2026

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

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

  • تمت إضافة SessionTestRule إلى الاختبار أثناء التشغيل. تتيح واجهة برمجة التطبيقات هذه (I672bc، b/516876144)
  • تم تحويل Session.create إلى دالة تعليق. (I5d27f)
  • تمت إضافة دعم دورة الحياة إلى XrDeviceTestRule (I2319c، b/512140272)
  • تمت إزالة التعليق التوضيحي ExperimentalXrDeviceLifecycleApi التجريبي غير المستخدَم للموافقة على المشاركة. (I46d95)
  • أضِف عمليات إلغاء متخصّصة لـ toString() لعدد من أنواع وقت التشغيل. تهدف هذه الأنواع إلى تقديم معلومات إضافية للمطوّرين لأغراض تصحيح الأخطاء، ولا يُفترض استخدامها في التطبيقات المنشورة أو التي سيتم شحنها.

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

  • ‫Fixed Pose.fromLookAt محاذاة الاتجاه الأمامي، وتصحيح استخراج المقياس في Matrix3، ومنع NaNs الرقمي في التسوية، وتحويل محور الزاوية، وحسابات angleBetween. (I7a3b5، b/367780918)

الإصدار ‎1.0.0-alpha15

‫17 يونيو 2026

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

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

  • تمت إضافة واجهة برمجة تطبيقات تجريبية لـ isProjectedServiceAvailable() (I44ba1)
  • تم عرض DeviceTrackingMode.INERTIAL كواجهة برمجة تطبيقات تجريبية عامة ضمن التعليق التوضيحي الجديد @ExperimentalInertialTrackingApi. (Ic3df3)
  • تمت إضافة Config.Builder. يمكن للتطبيقات إنشاء إعدادات مخصّصة من خلال استدعاء دوال الضبط على عنصر أداة الإنشاء، ثم استدعاء Builder.build. (I13142)
  • تمّت إزالة androidx.xr.runtime.FieldOfView. يجب أن تستخدم التطبيقات androidx.xr.runtime.math.FieldOfView بدلاً من ذلك. (I621ef)
  • يجب الآن تشغيل Session.create على @WorkerThread. (I2169e)
  • تمّت إضافة isProjectedServiceAvailable() إلى XrDevice (I507e9)
  • تمت إعادة تسمية DeviceTrackingMode.SPATIAL_LAST_KNOWN إلى DeviceTrackingMode.SPATIAL وDeviceTrackingMode.INERTIAL_LAST_KNOWN إلى DeviceTrackingMode.INERTIAL (I96f8b)
  • تعرض الدالتان Vector3.angleBetween وVector4.angleBetween الآن درجات بدلاً من وحدات راديان. (Ica8bc)
  • تمت إضافة واجهة برمجة التطبيقات QrCode (Ia0bbe)

الإصدار ‎1.0.0-alpha14

‫19 مايو 2026

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

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

  • إيقاف GeospatialMode.VPS_AND_GPS نهائيًا واستبداله بـ GeospatialMode.SPATIAL، وإطلاق وضع تتبُّع جديد منخفض الطاقة، GeospatialMode.INERTIAL، يستخدم فقط وحدة القياس بالقصور الذاتي ونظام تحديد المواقع العالمي (GPS). (I1e6cd)
  • تتم إزالة علامة الإيقاف النهائي من androidx.xr.runtime.FieldOfView. تُنشئ androidx.xr.runtime.math.FieldOfView اسمًا مستعارًا للنوع androidx.xr.runtime.FieldOfView استعدادًا لإزالته في الإصدار التالي. على العملاء نقل بياناتهم إلى الإصدار androidx.xr.runtime.math أينما كانوا يستخدمون الإصدار androidx.xr.runtime. (I6ce15)
  • تمت إضافة التعليق التوضيحي PreviewProjectedApi (Ic49f6)
  • تمت إزالة AugmentedObjectCategory.allSupported (I08656)
  • إضافة واجهات برمجة تطبيقات في XrDevice لتحديد ما إذا كان الجهاز يتيح تتبّع اليد وتتبّع العين وتقدير العمق والبيانات الجغرافية المكانية والعرض (I00696)
  • تم استبدال Session.getNativeData بـ XrDevice.getNativeInstanceData وSession.getNativeSessionData. (Ieb077)
  • تمت إضافة تعليق توضيحي إلى DeviceTrackingMode.INERTIAL_LAST_KNOWN باستخدام @PreviewSpatialApi. (I99868)
  • تمت إضافة XrDeviceTestRule لاستخدامه في اختبارات الوحدات. (I87584)
  • بالإضافة إلى CATEGORY_XR_PROJECTED_LAUNCHER، يتم استخدام هذا الثابت في ملف البيان للإشارة إلى أنّه يجب أن يكتشف النظام النشاط على أنّه مشغّل. (Ia3069)

المساهمة الخارجية

  • إضافة AugmentedImageMode إلى واجهة برمجة التطبيقات Config (I0cf09)

الإصدار ‎1.0.0-alpha13

‫6 مايو 2026

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

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

  • تم نقل TrackingState وVpsAvailabilityResult إلى androidx.xr.arcore package، وأصبحت الأنواع في androidx.xr.runtime متوقفة نهائيًا. (Ic7930، b/480462213)
  • يتم الآن تحديد Session.getNativeData() في الوحدة xr:runtime:runtime، كما يوفّر [nativeFunctionTablePointer] لبيئات التشغيل المتوافقة مع OpenXR. (Ifa862)
  • تم نقل واجهة برمجة التطبيقات NativeData إلى مكتبة xr:runtime:runtime. (I87954، b/494251500)
  • أصبحت Session.create وSession.configure غير شاملة الآن وتتطلّب عبارات else في عبارات when. (I9885e، b/495805998، b/495805998)
  • تم إيقاف androidx.xr.runtime.FieldOfView نهائيًا. يُرجى استخدام androidx.xr.runtime.math.FieldOfView بدلاً من ذلك. (Ia01a0، b/480233045)
  • تم تغيير اسم "Matrix4.pose" إلى "Matrix4.toPose()". تم إيقاف السمة "الوضعية" نهائيًا. (I329b4، b/493383490)
  • تمت إضافة واجهة برمجة التطبيقات XrServiceAvailability (If379e، b/493558010)
  • تمت إضافة التعليق التوضيحي ExperimentalXrServiceAvailabilityApi (Icab49، b/491069725)
  • إزالة اللاحقة الخاصة بـ @PreviewSpatialApi (If5242، b/491939311)
  • تمّت إعادة تسمية DeviceTrackingMode.LAST_KNOWN إلى SPATIAL_LAST_KNOWN (مع خيار احتياطي متوقّف نهائيًا)، وتمّت إضافة INERTIAL_LAST_KNOWN لتتبُّع 3 درجات من الحرية، كما تمّت إضافة TRACKING_DEGRADED إلى TrackingState. (Ie661c، b/445466590)
  • تمت إضافة واجهة برمجة التطبيقات XrLog. اضبط XrLog.isEnabled على true لتفعيل التسجيل في JetpackXR، واستخدِم [XrLog.Level] لضبط مستوى التسجيل. (I76a1f، b/463460895، b/487378441)
  • عند إضافة DISPLAY_CATEGORY_XR_PROJECTED، يتم استخدام هذا الثابت في ملف البيان للإشارة إلى أنّ النشاط مخصّص لشاشة عرض XR (I26d8b)

الإصدار ‎1.0.0-alpha12

‫25 مارس 2026

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

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

  • تم تغيير Config.augmentedObjectCategories من قائمة إلى مجموعة (I25a64، b/487376359)
  • تمت إزالة علامة unscaledGravityAlignedActivitySpace من Session.create. يتم الآن عرض ActivitySpace دائمًا بدون تغيير حجمه وبمحاذاة الجاذبية. (If6f11، b/458173423)
  • تمت إضافة تحميل زائد Session.create للسماح بتمرير "سياق Android" لتحديد نطاق الموارد. (I7d3fe، b/415805990، b/477386334)
  • تمت إضافة JvmOverloads إلى FloatSize2d.to3d وMatrix3.copy وMatrix4.copy (I69586، b/481371562)
  • تمت إضافة إمكانية ضبط الفئات لتتبُّع AugmentedObject في ملف الإعداد (I1f6e4، b/480220930)
  • تمت إضافة الوحدة xr:runtime:runtime-interfaces. (I52ac6، b/461561664)

الإصدار ‎1.0.0-alpha11

‫25 فبراير 2026

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

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

  • واجهة ConfigMode محظورة للاستخدام الداخلي (Ibfb87)
  • تم نقل androidx.xr.runtime.Config.GeospatialMode إلى مستوى الحزمة (Ibe682)
  • تم نقل androidx.xr.runtime.Config.FaceTrackingMode إلى مستوى الحزمة (Iac501)
  • تم نقل androidx.xr.runtime.Config.AnchorPersistenceMode إلى مستوى الحزمة (I0360f)
  • تم نقل androidx.xr.runtime.Config.DepthEstimationMode إلى مستوى الحزمة (I7e3e9)
  • تم نقل androidx.xr.runtime.Config.DeviceTrackingMode إلى مستوى الحزمة (I3aacd)
  • تم نقل androidx.xr.runtime.Config.HandTrackingMode إلى مستوى الحزمة (I658f3)
  • تم نقل androidx.xr.runtime.Config.PlaneTrackingMode إلى مستوى الحزمة (Ia251b)
  • تم نقل androidx.xr.runtime.XrDevice.DisplayBlendMode إلى مستوى الحزمة (I6f333)
  • تمت إضافة طريقة مصنع لإنشاء XrDevice باستخدام Context وSession وCoroutineContext. (I139c5)
  • تمت إضافة SpatialApiVersionHelper للمساعدة في طلب إصدار وقت التشغيل من Android XR المتوفّر على المنصة. (I7c53c)
  • تمت إضافة الوحدة xr:runtime:runtime-openxr (Ib42ea)

الإصدار ‎1.0.0-alpha10

‫28 يناير 2026

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

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

  • تم استبدال "ConfigMode.HeadTrackingMode" بـ "ConfigMode.DeviceTrackingMode". (le273e، b/467150206)
  • تمت إزالة طرق toNormalized وtimes(float) وdiv(float) في Quaternion. هذه الطرق غير ضرورية لأنّ جميع الأعداد الرباعية يتم تسويتها في وقت الإنشاء ولأنّ الفئة غير قابلة للتغيير. (l558fc، b/460210457)

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

  • تمت إضافة مستندات إلى Session.create توضّح كيفية تجنُّب إنشاء جلسة في سلسلة التعليمات البرمجية الرئيسية للتطبيق. (le5554، b/463687170)
  • تم منع التطبيقات من إنشاء BoundingBox بقيمة NaN. (l58c14، b/464025895)

الإصدار ‎1.0.0-alpha09

‫3 ديسمبر 2025

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

الإصدار ‎1.0.0-alpha08

‫19 نوفمبر 2025

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

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

  • تمت إضافة XrDevice لتقديم معلومات حول إمكانات الجهاز. (Ic9d1f)
  • تمت إضافة واجهة برمجة تطبيقات ConfigMode.isSupported جديدة للاستعلام عن إمكانات الجلسة. (Iff7af)
  • تمت إضافة واجهة برمجة التطبيقات XrDisplay.BlendMode. (I484e4)

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

  • تمت إعادة تسمية [XrDevice.getPreferredBlendMode] إلى [XrDevice.getPreferredDisplayBlendMode]. (I7e48f)

الإصدار ‎1.0.0-alpha07

‫22 أكتوبر 2025

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

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

  • أزِل SessionConfigureConfigureNotSupported واستبدِله بـ UnsupportedOperationException. (I7680f)

الإصدار ‎1.0.0-alpha06

‫24 سبتمبر 2025

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

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

  • تم نقل "HandJointType" إلى "xr:arcore:arcore" من "xr:runtime:runtime". (Iadb9c، b/409058039)
  • تغيير عامل التشغيل الخاص بالضرب في componentWiseMultiplication إلى Vector2 وVector3 وVector4 لتوسيع النطاق وإزالة رمز عامل التشغيل لتحقيق التوافق مع مكتبات الرياضيات الأخرى إزالة componentWiseDivision من فئات Vector بدلاً من استخدام Vector.scale(otherVector.inverse()) (I8e1f6، b/399146447)
  • إضافة [unscaled] لعرض مصفوفة بمقياس واحد (I6381d، b/434928658)
  • ستتم إزالة :xr:runtime:runtime-guava لأنّ Coroutines.kt تم استبداله بـ SuspendtoFutureAdapter. (I0cd3c، b/406597902)

الإصدار ‎1.0.0-alpha05

‫30 يوليو 2025

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

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

  • أضِف HandJointType وTrackingState. (I55880، b/334645808)
  • إتاحة تنفيذ Config للجميع (I95860، b/334645808)
  • تم تقديم نوعَي SessionCreateResult وSessionConfigureResult جديدَين. (Icb8cb، b/334645808)
  • أضِف فئة BoundingBox جديدة تمثّل مربّعًا محيطًا متوازيًا مع المحاور في الفضاء الثلاثي الأبعاد، ويتم تحديده من خلال نقاط الزاوية الدنيا والقصوى. (Ic68c5، b/423073468)

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

  • تمت إعادة تسمية androidx.xr.scenecore.PixelDimensions ونقلها إلى androidx.xr.runtime.math.IntSize2d. تمت إعادة تسمية androidx.xr.scenecore.Dimensions ونقلها إلى androidx.xr.runtime.math.FloatSize3d. تمت إعادة تسمية "androidx.xr.scenecore.PlaneType" إلى "androidx.xr.scenecore.PlaneOrientation". تمت إعادة تسمية "androidx.xr.scenecore.PlaneSemantic" إلى "androidx.xr.scenecore.PlaneSemanticType". (Ifd405، b/416456228)
  • تمت إزالة الصف androidx.xr.runtime.FoV. يمكنك استخدام androidx.xr.runtime.FieldOfView كبديل. (I9ae27)
  • تمت إضافة تحميل زائد إضافي للدالة Session.create يمكنه توفير LifecycleOwner للجلسة التي سيتم ربطها. يُرجى العِلم أنّه سيظلّ من الضروري تقديم "نشاط" لتحديد ملكية المرجع، ويجب أن يكون نطاق LifecycleOwner ضمن "النشاط". (I1690b)
  • تمت إعادة تسمية FakeRuntimeAnchor.anchorsCreated إلى anchorsCreatedCount (I96df9، b/424441218)
  • تمت إعادة تسمية قيم Config *Mode لتعكس سلوكها. (I6d247، b/414648065)
  • تتطلّب المشاريع التي تم إصدارها باستخدام Kotlin 2.0 استخدام الإصدار 2.0.0 أو إصدار أحدث من KGP (Idb6b5، b/344563182)
  • تم نقل واجهات برمجة التطبيقات المرتبطة بسلاسل البيان من :xr:runtime:runtime إلى :xr:runtime:runtime-manifest. تم تغيير اسم الحزمة من androidx.xr.runtime إلى androidx.xr.runtime.manifest. (I610ad، b/418800249)
  • تمت إزالة Session.resume() وSession.pause() وSession.destroy() من مساحة عرض واجهة برمجة التطبيقات. لم تعُد الجلسة LifecycleOwner. سيتم الآن ربط مراحل الجلسة بمراحل النشاط التي تم تمريرها في Session.create(). (I28a03)
  • تستخدم هذه المكتبة الآن تعليقات توضيحية بشأن إمكانية القيم الفارغة في JSpecify، وهي تعليقات توضيحية خاصة باستخدام النوع. على مطوّري Kotlin استخدام وسيطة المترجم البرمجي التالية لفرض الاستخدام الصحيح: -Xjspecify-annotations=strict (هذه هي القيمة التلقائية بدءًا من الإصدار 2.1.0 من مترجم Kotlin البرمجي) (Ia8420، b/326456246)
  • سيحتوي العنصر الرئيسي لوقت التشغيل (:xr:runtime:runtime) على واجهات برمجة تطبيقات غير متزامنة بنمط Kotlin فقط. يمكن لمطوّري Java الاعتماد على :xr:runtime:runtime-guava للوصول إلى واجهات برمجة التطبيقات المتوافقة. (I05d4a، b/426639315)
  • سيحتوي العنصر الرئيسي لوقت التشغيل (:xr:runtime:runtime) على واجهات برمجة تطبيقات غير متزامنة بنمط Kotlin فقط. يمكن لمطوّري Java الاعتماد على مكتبة xr:runtime:runtime-rxjava3 للوصول إلى واجهات برمجة التطبيقات المتوافقة. (I64122، b/426639775)
  • نقل الروتينات المشتركة إلى :xr:runtime:runtime-guava وعناصر Flow إلى :xr:runtime:runtime-rxjava3 (I60ae9)
  • تعرض الدالتان Session.create وSession.configure الآن الخطأ SecurityException عند عدم منح أذونات كافية بدلاً من عرض SessionCreatePermissionsNotGranted أو SessionConfigurePermissionsNotGranted. (I7c488، b/430651879)

الإصدار ‎1.0.0-alpha04

‫7 مايو 2025

تم إصدار "androidx.xr.runtime:runtime:1.0.0-alpha04" و"androidx.xr.runtime:runtime-openxr:1.0.0-alpha04" و"androidx.xr.runtime:runtime-testing:1.0.0-alpha04". يتضمّن الإصدار ‎1.0.0-alpha04 هذه التعديلات.

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

  • تنفّذ الفئة Session الآن androidx.lifecycle.LifecycleOwner لتحقيق المزيد من إمكانية التشغيل التفاعلي مع نماذج مراحل النشاط الحالية في Android.
  • يمكنك الاطّلاع هنا على سلاسل البيان الخاصة بمنصة Android XR.
  • تمت إضافة طرق Spatial Visibility Callback لتتبُّع وقت انتقال محتوى المشهد إلى داخل مجال رؤية المستخدم أو خارجه.
  • تمت إضافة نسخة رمز بديل من JxrPlatformAdapter (وجميع الفئات ذات الصلة).
  • سيتم استخدام Session في كل من SceneCore وRuntime بدلاً من Session في SceneCore.
  • تمت إضافة ActivityPose.hitTest، ما يتيح تقديم hitTest ضد المحتوى الافتراضي.
  • أصبحت إمكانية تحديد عمليات تنفيذ متعددة لـ Runtime متاحة الآن في وقت التجميع. سيتم تحميل واحد فقط في وقت التنفيذ استنادًا إلى مجموعة الخصائص الحالية للجهاز.
  • تمت إضافة نوع "المكوّن" الجديد SpatialPointerComponent، ما يتيح للعملاء تحديد الرمز المعروض للمؤشر أو إيقاف الرمز. يمكن حاليًا إرفاق هذا المكوّن بنسخ PanelEntity فقط.

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

  • إتاحة تنفيذ Config للجميع (I95860)
  • أضِف HandJointType وTrackingState. (I55880)
  • تتطلّب المشاريع التي تم إصدارها باستخدام Kotlin 2.0 استخدام الإصدار 2.0.0 أو إصدار أحدث من KGP (Idb6b5)
  • تم تغيير Hand.isActive (boolean) إلى Hand.trackingState. تم تعديل طريقة تنفيذ OpenXR وفقًا لذلك.
  • تم تغيير متطلبات إذن android.permission.SCENE_UNDERSTANDING في Session.configure إلى android.permission.SCENE_UNDERSTANDING_COARSE.
  • تم تنفيذ LifecycleManager.configure، ويتم الآن تمرير عنصر Config يحتوي على سمة لكل ميزة قابلة للإعداد في وقت التشغيل.
  • يمكن الآن استدعاء Session.configure باستخدام Config من أجل ضبط ميزات وقت التشغيل المتاحة.
  • يتيح Session.create الآن تمرير CoroutineContext بدلاً من CoroutineDispatcher.
  • تتيح Session.create تحميل ARCore لـ Jetpack XR و/أو SceneCore. يجب توفير واحد على الأقل (تتوفّر إصدارات تجريبية).
  • تعرض الدالة FakePerceptionManager الخطأ AnchorInvalidUuidException عند تمرير معرّف UUID غير صالح إلى Anchor.load وAnchor.unpersist.
  • لم يعُد CoreState فئة بيانات.

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

  • تم إصلاح إعدادات Runtime proguard.

الإصدار ‎1.0.0-alpha03

‫26 فبراير 2025

تم إصدار androidx.xr.runtime:runtime:1.0.0-alpha03 وandroidx.xr.runtime:runtime-openxr:1.0.0-alpha03 وandroidx.xr.runtime:runtime-testing:1.0.0-alpha03 بدون أي تغييرات ملحوظة منذ آخر إصدار أولي. يتضمّن الإصدار ‎1.0.0-alpha03 هذه التعديلات.

الإصدار ‎1.0.0-alpha02

‫12 فبراير 2025

تم إصدار "androidx.xr.runtime:runtime:1.0.0-alpha02" و"androidx.xr.runtime:runtime-openxr:1.0.0-alpha02" و"androidx.xr.runtime:runtime-testing:1.0.0-alpha02". يتضمّن الإصدار ‎1.0.0-alpha02 هذه التعديلات.

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

  • ستعرض الآن دوال وقت التشغيل OpenXR التي تعرض Anchor الخطأ AnchorResourcesExhaustedException إذا صادفت رمز خطأ يشير إلى أنّه تم بلوغ الحدّ الأقصى لمورد OpenXR.
  • يجب الآن الحصول على الإذن android.permission.HAND_TRACKING لاستخدام Session.create وSession.resume.

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

  • تمت إضافة ميزة تتبُّع اليد.

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

  • يصبح إنشاء نقاط الارتكاز أكثر استقرارًا عند التشغيل على محاكي

الإصدار ‎1.0.0-alpha01

‫12 ديسمبر 2024

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

ميزات الإصدار الأوّلي

الإصدار الأوّلي من Jetpack XR Runtime تحتوي هذه المكتبة على أجزاء أساسية من الوظائف لمجموعة مكتبات Jetpack XR. ويشمل ذلك اكتشاف الإمكانات وإدارة مراحل النشاط والإعدادات وغير ذلك. توفّر مكتبة وقت التشغيل صيغًا مختلفة (مثل runtime-openxr أو runtime-testing) حسب منصة التنفيذ. بالإضافة إلى ذلك، توفّر هذه المكتبة تجريدات رياضية أساسية، مثل Vector3 وMatrix4، يتم استخدامها في جميع مساحة Jetpack XR API.

  • Session: يوفّر لك عناصر تحكّم دقيقة في نظام الواقع الممتد، بما في ذلك تحديد وقت تنفيذ المعالجة ووقت عدم تنفيذها والإعداد العام. وهو أيضًا المعرّف الذي ستستخدمه في جميع واجهات برمجة التطبيقات الأخرى للاستفادة من إمكانات النظام الأساسية.

  • ‫Pose: موقع جغرافي في نظام إحداثيات عشوائي يتضمّن موضعًا واتجاهًا مرتبطَين به. ستستخدِم هذه الفئة لنقل معلومات حول موقع الكائنات إلى ARCore for Jetpack XR وJetpack SceneCore.

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

  • configure لا يعمل حاليًا، ولكن ستضيف الإصدارات المستقبلية إعدادات جديدة يمكنك استخدامها للتحكّم في سلوك Session.