وقت تشغيل الواقع الممتد

ابدأ جلسة الواقع المعزّز أو الجلسة الثلاثية الأبعاد المخصّصة باستخدام وقت التشغيل الأصلي.
آخر تعديل الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأولي
7 أيار (مايو) 2025 - - - 1.0.0-alpha04

تحديد التبعيات

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

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

رائعKotlin 
dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha04"

    // Use in environments that do not support OpenXR
    testImplementation "androidx.xr.runtime:runtime-testing:1.0.0-alpha04"
}
 
dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha04")

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

لمزيد من المعلومات عن العناصر الاعتمادية، اطّلِع على مقالة إضافة عناصر الاعتماد الخاصة بالإصدار.

الملاحظات

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

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

اطّلِع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

الإصدار 1.0

الإصدار 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 وتوثيقها.
  • تمّت إضافة طرق تمديد "الاستدعاء في ميزة "الرؤية المكانية" للتتبّع عندما يتحرّك محتوى المشهد داخل أو خارج مجال رؤية المستخدم.
  • تمت إضافة نسخة نموذجية من JxrPlatformAdapter (وجميع الفئات ذات الصلة).
  • سيتم استخدام Session في كلّ من SceneCore وRuntime بدلاً من Session في SceneCore.
  • تمّت إضافة ActivityPose.hitTest، ما يتيح hitTest ضد المحتوى الافتراضي.
  • أصبح من الممكن الآن تحديد عمليات تنفيذ متعددة لوقت التشغيل في وقت الترجمة. سيتم تحميل ملف واحد فقط في وقت التنفيذ استنادًا إلى مجموعة ميزات الجهاز الحالية.
  • تمت إضافة نوع مكوّن جديد SpatialPointerComponent، ما يتيح للعملاء تحديد الرمز المعروض للمؤشر أو إيقاف الرمز. يمكن حاليًا إرفاق هذا المكوّن بمثيلات PanelEntity فقط.

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

  • اجعل تنفيذ Config علنيًا. (I95860)
  • أضِف HandJointType وTrackingState. (I55880)
  • تتطلّب المشاريع التي تم إصدارها باستخدام Kotlin 2.0 استخدام KGP 2.0.0 أو إصدار أحدث (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 فئة بيانات.

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

  • تم إصلاح إعدادات 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 وظائف وقت التشغيل التي تعرض مرجعًا تُعرِض الآن 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 نُسخًا مختلفة (مثل runtime-openxr أو runtime-testing) استنادًا إلى منصّة التنفيذ. بالإضافة إلى ذلك، تقدّم هذه المكتبة تجريدات رياضية أساسية مثل Vector3 وMatrix4 التي يتم استخدامها في جميع مساحات عرض Jetpack XR API.

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

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

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

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