סביבת זמן ריצה של XR

להתחיל סשן מותאם אישית של AR או 3D עם זמן הריצה המקורי שלנו.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫7 באוקטובר 2026 - ‎1.0.0-rc02 - ‎1.1.0-alpha01

הצהרה על יחסי תלות

כדי להוסיף תלות בזמן ריצה של XR, צריך להוסיף את מאגר Maven של Google לפרויקט. מידע נוסף זמין במאמר בנושא מאגר ה-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")
}

מידע נוסף זמין במאמר הוספת יחסי תלות ב-build.

משוב

המשוב שלכם עוזר לנו לשפר את 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 מכילה את השמירות האלה.

שינויים ב-API

  • הוספת 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 מכילה את השמירות האלה.

שינויים ב-API

  • התוסף SessionTestRule נוסף לבדיקה בזמן ריצה. ‫API הזה (I672bc, ‏ b/516876144)
  • הפונקציה Converted Session.create הומרה לפונקציית השהיה. (I5d27f)
  • נוספה תמיכה במחזור החיים של XrDeviceTestRule (I2319c, ‏ b/512140272)
  • הוסרה הערה ניסיונית להסכמה להשתתפות בניסוי ExperimentalXrDeviceLifecycleApi שלא הייתה בשימוש. (I46d95)
  • הוספת שינויים מיוחדים של toString() למספר סוגים של זמן ריצה. הסוגים האלה נועדו לספק למפתחים מידע נוסף למטרות ניפוי באגים, ולא לשימוש באפליקציות שנמצאות בשלב הפרודקשן או באפליקציות שנשלחות.

תיקוני באגים

  • תוקן 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 מכילה את השמירות האלה.

שינויים ב-API

  • נוסף API לבדיקה של isProjectedServiceAvailable() (I44ba1)
  • חשפנו את DeviceTrackingMode.INERTIAL כ-API ציבורי ניסיוני עם ההערה החדשה @ExperimentalInertialTrackingApi. (Ic3df3)
  • Config.Builder נוסף. אפליקציות יכולות ליצור הגדרות בהתאמה אישית על ידי קריאה לפונקציות setter באובייקט 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)
  • נוסף API של QrCode (‏Ia0bbe)

גרסה ‎1.0.0-alpha14

‫19 במאי 2026

‫androidx.xr.runtime:runtime-*:1.0.0-alpha14 מופץ. גרסה ‎1.0.0-alpha14 מכילה את השמירות האלה.

שינויים ב-API

  • הוצאנו משימוש את 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 צריכים לעבור לגרסה androidx.xr.runtime.math. (I6ce15)
  • נוספה ההערה PreviewProjectedApi (Ic49f6)
  • הוסר AugmentedObjectCategory.allSupported (I08656)
  • הוספת ממשקי API ב-XrDevice לקביעת התמיכה של המכשיר במעקב ידיים, מעקב עיניים, הערכת עומק, מיקום גיאוגרפי ורינדור. (I00696)
  • ‫Session.getNativeData הוחלף ב-XrDevice.getNativeInstanceData וב-Session.getNativeSessionData. (Ieb077)
  • הערה לגבי DeviceTrackingMode.INERTIAL_LAST_KNOWN עם @PreviewSpatialApi. (I99868)
  • הוספנו את XrDeviceTestRule לשימוש בבדיקות יחידה. (I87584)
  • הוספת CATEGORY_XR_PROJECTED_LAUNCHER, הקבוע הזה משמש בקובץ המניפסט כדי לציין שהמערכת צריכה לזהות את הפעילות כמשגר. (Ia3069)

External Contribution

  • הוספת AugmentedImageMode ל-API‏ Config (I0cf09)

גרסה ‎1.0.0-alpha13

‫6 במאי 2026

‫androidx.xr.runtime:runtime-*:1.0.0-alpha13 מופץ. גרסה ‎1.0.0-alpha13 מכילה את השמירות האלה.

שינויים ב-API

  • הסוגים 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 כבר לא ממצות את כל האפשרויות, וצריך להוסיף להן משפטי else במשפטי when. (I9885e, b/495805998, b/495805998)
  • הגרסה androidx.xr.runtime.FieldOfView הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-androidx.xr.runtime.math.FieldOfView. (Ia01a0, b/480233045)
  • השם של Matrix4.pose השתנה לשם Matrix4.toPose(). המאפיין pose יצא משימוש. ‫(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)
  • נוסף API של 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 מכילה את השמירות האלה.

שינויים ב-API

  • השדה Config.augmentedObjectCategories שונה מ-List ל-Set,‏ (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 מכילה את השמירות האלה.

שינויים ב-API

  • ממשק מוגבל 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)
  • נוספה שיטת factory ליצירת 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 מכילה את השמירות האלה.

שינויים ב-API

  • ‫ConfigMode.HeadTrackingMode הוחלף ב-ConfigMode.DeviceTrackingMode. ‫(le273e, ‏ b/467150206)
  • הוסרו השיטות toNormalized,‏ times(float) ו-div(float) של Quaternion. השיטות האלה מיותרות, כי כל הקווטרניונים מנורמלים בזמן הבנייה, והמחלקה היא בלתי משתנה. (l558fc, b/460210457)

תיקוני באגים

  • הוספנו מסמכים ל-Session.create שמדגימים איך להימנע מיצירת סשן ב-thread הראשי של האפליקציה. (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 API חדש להרצת שאילתות לגבי יכולות הסשן. (Iff7af)
  • נוסף API של XrDisplay.BlendMode. (I484e4)

שינויים ב-API

  • השם של [XrDevice.getPreferredBlendMode] שונה ל-[XrDevice.getPreferredDisplayBlendMode]. (I7e48f)

גרסה ‎1.0.0-alpha07

‫22 באוקטובר 2025

‫androidx.xr.runtime:runtime-*:1.0.0-alpha07 מופץ. גרסה ‎1.0.0-alpha07 מכילה את השמירות האלה.

שינויים ב-API

  • מסירים את SessionConfigureConfigureNotSupported ומחליפים אותו ב-UnsupportedOperationException. (I7680f)

גרסה ‎1.0.0-alpha06

‫24 בספטמבר 2025

‫androidx.xr.runtime:runtime-*:1.0.0-alpha06 מופץ. גרסה ‎1.0.0-alpha06 מכילה את השמירות האלה.

שינויים ב-API

  • האתר 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 יוסר כי הוא הוחלף בSuspendtoFutureAdapter.Coroutines.kt (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)

שינויים ב-API

  • השם של 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 vals שונה כדי לשקף את ההתנהגות שלה. (I6d247, ‏ b/414648065)
  • כדי להשתמש בפרויקטים שפורסמו עם Kotlin 2.0, צריך KGP 2.0.0 או גרסה חדשה יותר (Idb6b5,‏ b/344563182)
  • ממשקי API שקשורים למחרוזות של מניפסט הועברו מ-:xr:runtime:runtime ל-:xr:runtime:runtime-manifest. שם החבילה השתנה מ-androidx.xr.runtime ל-androidx.xr.runtime.manifest. ‫(I610ad, ‏ b/418800249)
  • הוסרו מהפלטפורמה של ה-API‏ Session.resume(), Session.pause() ו-Session.destroy(). הסשן כבר לא LifecycleOwner. מחזור החיים של הסשן יצורף למחזור החיים של הפעילות שמועברת ב-Session.create(). (I28a03)
  • הספרייה הזו משתמשת עכשיו באנוטציות של JSpecify nullness, שהן מסוג type-use. מפתחי Kotlin צריכים להשתמש בארגומנט הקומפיילר הבא כדי לאכוף שימוש נכון: -Xjspecify-annotations=strict (זוהי ברירת המחדל החל מגרסה 2.1.0 של קומפיילר Kotlin) (Ia8420, ‏ b/326456246)
  • הארטיפקט הראשי של Runtime ‏ (:xr:runtime:runtime) יכיל רק ממשקי API אסינכרוניים בסגנון Kolin. מפתחי Java יכולים להסתמך על :xr:runtime:runtime-guava כדי לגשת לממשקי API תואמים. (I05d4a, ‏ b/426639315)
  • הארטיפקט הראשי של Runtime ‏ (:xr:runtime:runtime) יכיל רק ממשקי API אסינכרוניים בסגנון Kotlin. מפתחי Java יכולים להסתמך על הספרייה xr:runtime:runtime-rxjava3 כדי לגשת לממשקי API תואמים. (I64122, ‏ b/426639775)
  • העברת קורוטינות אל :xr:runtime:runtime-guava והעברת Flows אל :xr:runtime:runtime-rxjava3. (I60ae9)
  • הפונקציות Session.create ו-Session.configure מקפיצות עכשיו הודעת שגיאה (throw) 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 כדי לעקוב אחרי תנועה של תוכן הסצנה בתוך שדה הראייה של המשתמש או מחוצה לו.
  • הוספנו גרסת stub של JxrPlatformAdapter (ושל כל הכיתות שקשורות אליה).
  • הסשן ישמש גם ב-SceneCore וגם ב-Runtime במקום הסשן ב-SceneCore.
  • ‫ActivityPose.hitTest נוסף, והוא מאפשר hitTest נגד תוכן וירטואלי.
  • יש עכשיו תמיכה בציון של כמה הטמעות של Runtime בזמן ההידור. רק אחד מהם ייטען בזמן ההפעלה, בהתאם לסט התכונות של המכשיר הנוכחי.
  • נוסף סוג רכיב חדש SpatialPointerComponent, שמאפשר ללקוחות לציין את הסמל שמוצג עבור מצביע העכבר, או להשבית את הסמל. בשלב הזה, אפשר לצרף את הרכיב הזה רק למופעים של PanelEntity.

שינויים ב-API

  • הופכים את ההטמעה של 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 שמחזירות 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, שמשמשות בכל ממשק ה-API של Jetpack XR.

  • ‫Session: מספק לכם אמצעי בקרה מפורטים על מערכת ה-XR, כולל האפשרות להחליט מתי העיבוד מתבצע ומתי לא, וגם על ההגדרה הכוללת. זה גם ה-handle שבו תשתמשו בכל שאר ממשקי ה-API כדי לפתוח את היכולות הבסיסיות של המערכת.

  • ‫Pose: מיקום במערכת קואורדינטות שרירותית שיש לו מיקום ואוריינטציה שמשויכים אליו. תשתמשו במחלקה הזו כדי להעביר את המיקום של אובייקטים ל-ARCore for Jetpack XR ול-Jetpack SceneCore.

בעיות מוכרות

  • כרגע, configure לא מבצע פעולה. בגרסאות עתידיות יתווספו הגדרות חדשות שתוכלו להשתמש בהן כדי לשלוט בהתנהגות של Session.