زمان اجرای واقعیت گسترده

جلسه واقعیت افزوده یا سه‌بعدی سفارشی‌تان را با زمان اجرای بومی ما شروع کنید.
جدیدترین به‌روزرسانی نسخه پایدار نامزد انتشار انتشار نسخه بتا نسخه آلفا
۷ اکتبر ۲۰۲۶ - 1.0.0-rc02 - 1.1.0-alpha01

اعلام وابستگی‌ها

برای افزودن وابستگی به زمان اجرای XR، باید مخزن Google Maven را به پروژه‌تان اضافه کنید. برای اطلاعات بیشتر، مخزن Maven در Google را بخوانید.

وابستگی‌های آرتیفکت‌های موردنیازتان را در فایل build.gradle برای برنامه یا واحدتان اضافه کنید:

شیک

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"
}

کاتلین

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 کمک می‌کند. اگر مشکلات جدیدی پیدا کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل‌از ایجاد کتابخانه جدید، مشکلات موجود در این کتابخانه را بررسی کنید. با کلیک کردن روی دکمه ستاره می‌توانید رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد مشکل جدید

برای کسب اطلاعات بیشتر، به مستندات «پیگیری مسائل» مراجعه کنید.

زمان اجرا

نسخه 1.0

نسخه 1.0.0-rc02

۷ اکتبر ۲۰۲۶

‫androidx.xr.runtime:runtime-*:1.0.0-rc02 منتشر شد. نسخه 1.0.0-rc02 شامل این تعهدات است.

رفع اشکال‌ها

  • مشکلات مختلفی در androidx.xr.runtime و androidx.xr.scenecore رفع شد تا ایمنی حافظه و مدیریت چرخه حیات منابع بهبود یابد. این شامل به‌روزرسانی‌های منطق پاک‌سازی مرجع و مدیریت زمینه‌ای برای جلوگیری از نشت حافظه است. (Id61f8)

نسخه ۱.۱

نسخه 1.1.0-alpha01

۹ سپتامبر ۲۰۲۶

‫androidx.xr.runtime:runtime-*:1.1.0-alpha01 منتشر شد. نسخه 1.1.0-alpha01 شامل این تعهدها است.

تغییرات میانای برنامه‌سازی کاربردی

  • افزودن SPATIAL_API_V4 به SpatialApiVersions (I71e7a)

نسخه 1.0

نسخه 1.0.0-rc01

۹ سپتامبر ۲۰۲۶

‫androidx.xr.runtime:runtime-*:1.0.0-rc01 منتشر شد. نسخه 1.0.0-rc01 شامل این تعهدها است.

تغییرات رفتار

  • مدیریت رویدادهای چرخه حیات داخلی بهبود یافت. (I2f7b8،‏ If1bc3،‏ Ifa75e)

نسخه 1.0.0-beta02

‫۱۲ اوت ۲۰۲۶

‫androidx.xr.runtime:runtime-*:1.0.0-beta02 منتشر شد. نسخه 1.0.0-beta02 شامل این تعهدها است.

رفع اشکال‌ها

  • تشخیص پشتیبانی از OpenXR در محیط‌های شبیه‌سازی‌شده بهبود یافت. (Ifec51)
  • ‫toString() در کلاس‌های بیشتری برای اشکال‌زدایی پیاده‌سازی شد. (I67d83)
  • ‫XrDeviceTestRule را طوری اصلاح کنید که وقتی XrDevice پس‌از اعمال تنظیمات ایجاد می‌شود کار کند. (Ica32c)

نسخه 1.0.0-beta01

‫۱۵ ژوئیه ۲۰۲۶

‫androidx.xr.runtime:runtime-*:1.0.0-beta01 منتشر شد. نسخه 1.0.0-beta01 حاوی این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

  • ‫SessionTestRule به runtime-testing اضافه شد. این میانای برنامه‌سازی کاربردی (I672bc، b/516876144)
  • ‫Session.create به تابع تعلیق تبدیل شد. (I5d27f)
  • پشتیبانی از چرخه عمر به XrDeviceTestRule اضافه شد (I2319c، b/512140272)
  • گزارمان موافقت آزمایشی ExperimentalXrDeviceLifecycleApi بلااستفاده برداشته شد. (I46d95)
  • جایگزین‌های تخصصی toString() را برای تعدادی از انواع زمان اجرا اضافه کنید. این نوع‌ها برای ارائه اطلاعات بیشتر به توسعه‌دهندگان برای اهداف اشکال‌زدایی درنظر گرفته شده‌اند و برای استفاده در برنامه‌های تولید یا ارسال‌شده درنظر گرفته نشده‌اند.

رفع اشکال‌ها

  • «ژست ثابت».fromLookAt تراز کردن جهت جلو، استخراج مقیاس اصلاح‌شده در Matrix3، و جلوگیری از NaNs عددی در عادی‌سازی، تبدیل محور-زاویه، و محاسبات angleBetween. (I7a3b5، b/367780918)

نسخه 1.0.0-alpha15

‫۱۷ ژوئن ۲۰۲۶

‫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

‫۱۹ مه ۲۰۲۶

‫androidx.xr.runtime:runtime-*:1.0.0-alpha14 منتشر شد. نسخه 1.0.0-alpha14 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

  • ‫GeospatialMode.VPS_AND_GPS را به‌نفع GeospatialMode.SPATIAL منسوخ می‌کنیم و حالت ردیابی جدیدی با توان کمتر، GeospatialMode.INERTIAL، معرفی می‌کنیم که فقط از IMU و 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

۶ مه ۲۰۲۶

‫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 API به کتابخانه xr:runtime:runtime منتقل شد. (I87954, b/494251500)
  • ‫Session.create و Session.configure اکنون غیرجامع هستند و در عبارت‌های when به بندهای else نیاز دارند. (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 API (If379e،‏ b/493558010) اضافه شد
  • حاشیه‌نویسی ExperimentalXrServiceAvailabilityApi را اضافه کرد (Icab49، b/491069725)
  • پسوند @PreviewSpatialApi را بردارید (If5242، b/491939311)
  • نام DeviceTrackingMode.LAST_KNOWN به SPATIAL_LAST_KNOWN تغییر کرد (با یک برگشت منسوخ)، INERTIAL_LAST_KNOWN برای ردیابی 3DoF اضافه شد، و TRACKING_DEGRADED به TrackingState اضافه شد. (Ie661c، b/445466590)
  • ‫XrLog API اضافه شد. برای فعال کردن گزارش‌گیری در JetpackXR، مقدار XrLog.isEnabled را روی true تنظیم کنید و از [XrLog.Level] برای تنظیم سطح گزارش استفاده کنید. (I76a1f،‏ b/463460895،‏ b/487378441)
  • با افزودن DISPLAY_CATEGORY_XR_PROJECTED، این ثابت در فایل «مانیفست» استفاده می‌شود تا نشان دهد فعالیت برای نمایشگر مجازی‌سازی‌شده XR درنظر گرفته شده است (I26d8b)

نسخه 1.0.0-alpha12

۲۵ مارس ۲۰۲۶

‫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

۲۵ فوریه ۲۰۲۶

‫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 بااستفاده از «زمینه»، «جلسه»، و CoroutineContext اضافه شد. (I139c5)
  • ‫SpatialApiVersionHelper اضافه شد تا به پُرسمان نسخه زمان اجرای Android XR دردسترس در پلاتفرم کمک کند. (I7c53c)
  • ‫xr:runtime:runtime-openxr واحد (Ib42ea) اضافه شد

نسخه 1.0.0-alpha10

‫۲۸ ژانویه ۲۰۲۶

‫androidx.xr.runtime:runtime-*:1.0.0-alpha10 منتشر شد. نسخه 1.0.0-alpha10 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

  • ‫ConfigMode.HeadTrackingMode با ConfigMode.DeviceTrackingMode جایگزین شد. (le273e، b/467150206)
  • روش‌های toNormalized، times(float)، div(float) مربوط به «چهارگان» برداشته شد. این روش‌ها اضافی هستند زیرا همه «کواترنیون‌ها» در زمان ساخت عادی‌سازی می‌شوند و کلاس تغییرناپذیر است. (l558fc, b/460210457)

رفع اشکال‌ها

  • به Session.create مستنداتی اضافه شد که نشان می‌دهد چگونه از ایجاد جلسه در رشته اصلی برنامه جلوگیری کنید. (le5554، b/463687170)
  • برنامه‌ها از ایجاد BoundingBox با مقدار NaN منع شدند. (l58c14, b/464025895)

نسخه 1.0.0-alpha09

۳ دسامبر ۲۰۲۵

‫androidx.xr.runtime:runtime-*:1.0.0-alpha09 منتشر شد. نسخه 1.0.0-alpha09 شامل این تغییرات است.

نسخه 1.0.0-alpha08

‫۱۹ نوامبر ۲۰۲۵

‫androidx.xr.runtime:runtime-*:1.0.0-alpha08 منتشر شد. نسخه 1.0.0-alpha08 شامل این تعهدها است.

ویژگی‌های جدید

  • ‫XrDevice اضافه شد تا اطلاعاتی درباره قابلیت‌های دستگاه ارائه دهد. (Ic9d1f)
  • «میانای برنامه‌سازی کاربردی» جدید ConfigMode.isSupported برای پُرسمان قابلیت‌های جلسه اضافه شد. (Iff7af)
  • ‫XrDisplay.BlendMode API اضافه شد. (I484e4)

تغییرات میانای برنامه‌سازی کاربردی

  • نام [XrDevice.getPreferredBlendMode] به [XrDevice.getPreferredDisplayBlendMode] تغییر کرد. (I7e48f)

نسخه 1.0.0-alpha07

‫۲۲ اکتبر ۲۰۲۵

‫androidx.xr.runtime:runtime-*:1.0.0-alpha07 منتشر شد. نسخه 1.0.0-alpha07 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

  • ‫SessionConfigureConfigureNotSupported را بردارید و آن را با UnsupportedOperationException جایگزین کنید. (I7680f)

نسخه 1.0.0-alpha06

‫۲۴ سپتامبر ۲۰۲۵

‫androidx.xr.runtime:runtime-*:1.0.0-alpha06 منتشر شد. نسخه 1.0.0-alpha06 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

  • ‫HandJointType از xr:runtime:runtime به xr:arcore:arcore منتقل شد. (Iadb9c، b/409058039)
  • درحال تغییر دادن اپراتور زمان برای componentWiseMultiplication برای Vector2،‏ Vector3،‏ Vector4 برای مقیاس‌بندی و برداشتن نماد اپراتور برای یکنواختی با دیگر کتابخانه‌های ریاضی. همچنین componentWiseDivision را به‌جای استفاده از Vector.scale(otherVector.inverse()) از کلاس‌های «بردار» برمی‌داریم. (I8e1f6, b/399146447)
  • افزودن [بدون مقیاس] برای برگرداندن «ماتریس» با مقیاس یک. (I6381d،‏ b/434928658)
  • ‫:xr:runtime:runtime-guava برداشته خواهد شد زیرا Coroutines.kt با SuspendtoFutureAdapter جایگزین شده است. (I0cd3c،‏ b/406597902)

نسخه 1.0.0-alpha05

۳۰ ژوئیه ۲۰۲۵

‫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)
  • نام مقادیر پیکربندی *Mode تغییر کرده است تا رفتارش را نشان دهد. (I6d247، b/414648065)
  • برای استفاده از پروژه‌های منتشرشده با Kotlin 2.0، باید از KGP 2.0.0 یا نسخه‌های جدیدتر استفاده شود (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 nullness annotations استفاده می‌کند که نوع استفاده است. توسعه‌دهندگان Kotlin باید از استدلال کامپایلر زیر برای اعمال استفاده صحیح استفاده کنند: -Xjspecify-annotations=strict (این استدلال از نسخه ۲.۱.۰ کامپایلر Kotlin به‌صورت پیش‌فرض شروع می‌شود) (Ia8420، b/326456246)
  • عنصر اصلی Runtime (:xr:runtime:runtime) فقط شامل میاناهای برنامه‌سازی کاربردی ناهم‌زمان به سبک Kolin خواهد بود. توسعه‌دهندگان Java می‌توانند برای دسترسی به میاناهای برنامه‌سازی کاربردی سازگار به :xr:runtime:runtime-guava تکیه کنند. (I05d4a،‏ b/426639315)
  • آرتیفکت اصلی Runtime (:xr:runtime:runtime) فقط شامل میاناهای برنامه‌سازی کاربردی ناهم‌زمان به سبک Kotlin خواهد بود. توسعه‌دهندگان Java می‌توانند برای دسترسی به میاناهای برنامه‌سازی کاربردی سازگار به کتابخانه xr:runtime:runtime-rxjava3 تکیه کنند. (I64122، b/426639775)
  • «روال‌های هم‌زمان» را به :xr:runtime:runtime-guava و «جریان‌ها» را به :xr:runtime:runtime-rxjava3 منتقل کنید. (I60ae9)
  • اکنون Session.create و Session.configure درصورت اعطا نشدن اجازه‌های کافی، به‌جای برگرداندن SessionCreatePermissionsNotGranted یا SessionConfigurePermissionsNotGranted، SecurityException را پرتاب می‌کنند. (I7c488،‏ b/430651879)

نسخه 1.0.0-alpha04

۷ مه ۲۰۲۵

‫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 شامل این تعهدها است.

ویژگی‌های جدید

  • اکنون «جلسه» androidx.lifecycle.LifecycleOwner را برای قابلیت تعامل‌پذیری بیشتر با الگوهای چرخه حیات Android موجود پیاده‌سازی می‌کند.
  • رشته‌های مانیفست برای Android XR در اینجا مشخص و مستند شده‌اند.
  • روش‌های افزونه «بازخوانی رؤیت‌پذیری فضایی» برای نظارت بر زمان حرکت محتوای صحنه به داخل یا خارج از میدان دید کاربر اضافه شد.
  • نسخه ناقصی از JxrPlatformAdapter (و همه کلاس‌های مرتبط آن) اضافه شد.
  • به‌جای «جلسه» در SceneCore، از «جلسه» در 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 پشتیبانی می‌کند. حداقل یکی باید ارائه شود (نسخه‌های آزمایشی دردسترس است).
  • وقتی یک UUID نامعتبر به Anchor.load و Anchor.unpersist ارسال می‌شود، FakePerceptionManager یک AnchorInvalidUuidException ایجاد می‌کند.
  • ‫CoreState دیگر کلاس داده نیست.

رفع اشکال‌ها

  • پیکربندی‌های ثابت زمان اجرای Proguard.

نسخه 1.0.0-alpha03

‫۲۶ فوریه ۲۰۲۵

‫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

‫۱۲ فوریه ۲۰۲۵

‫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 که «لنگر» برمی‌گردانند اکنون درصورت مواجهه با کد خطایی که نشان می‌دهد به حد مجاز منبع OpenXR رسیده‌اید، AnchorResourcesExhaustedException را پرتاب می‌کنند.
  • اکنون اجازه android.permission.HAND_TRACKING برای Session.create و Session.resume لازم است.

ویژگی‌های جدید

  • پشتیبانی از ردیابی دست اضافه شد.

رفع اشکال‌ها

  • ایجاد کردن نقاط اتکا هنگام اجرا در شبیه‌ساز پایدارتر است

نسخه 1.0.0-alpha01

‫۱۲ دسامبر ۲۰۲۴

‫androidx.xr.runtime:runtime-* 1.0.0-alpha01 منتشر شد.

ویژگی‌های انتشار اولیه

اولین نسخه پخش Jetpack XR Runtime. این کتابخانه شامل بخش‌های اساسی عملکرد برای مجموعه کتابخانه‌های Jetpack XR است. این شامل قابلیت کاوش، مدیریت چرخه عمر، پیکربندی، و موارد دیگر می‌شود. کتابخانه زمان اجرا بسته به پلاتفرم اجرا، تنوع‌های مختلفی (مثلاً runtime-openxr یا runtime-testing) ارائه می‌دهد. علاوه‌براین، این کتابخانه انتزاع‌های ریاضی بنیادی مانند Vector3 و Matrix4 را ارائه می‌دهد که در سراسر سطح API Jetpack XR استفاده می‌شوند.

  • Session: کنترل‌های دقیق و جزئی بر سیستم «واقعیت گسترده» دراختیارتان قرار می‌دهد، ازجمله تصمیم‌گیری درباره اینکه پردازش چه زمانی اجرا شود و چه زمانی اجرا نشود و پیکربندی کلی. این همچنین دسته‌ای است که در همه میاناهای برنامه‌سازی کاربردی دیگر برای باز کردن قابلیت‌های سیستم زیرین استفاده خواهید کرد.

  • Pose: مکانی در یک سیستم مختصات اختیاری که موقعیت و جهت‌گیری مرتبط با آن دارد. از این کلاس برای انتقال مکان اشیا به ARCore برای Jetpack XR و Jetpack SceneCore استفاده خواهید کرد.

مشکلات شناخته‌شده

  • درحال‌حاضر configure یک عملیات بدون نتیجه است. نسخه‌های پخش آینده تنظیمات جدیدی اضافه خواهند کرد که می‌توانید از آن‌ها برای کنترل عملکرد Session استفاده کنید.