XR Runtime

התחלת סשן 3D או AR בהתאמה אישית באמצעות סביבת זמן ריצה מקורית.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
7 במאי 2025 - - - 1.0.0-alpha04

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

כדי להוסיף תלות בסביבת זמן הריצה של XR, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין ב מאגר Maven של Google.

מוסיפים את יחסי התלות של הארטיפקטים הנדרשים בקובץ build.gradle של האפליקציה או המודול:

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

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

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. אם נתקלתם בבעיות חדשות או שיש לכם רעיונות לשיפור הספרייה הזו, נשמח לשמוע מכם. לפני שיוצרים בעיה חדשה, כדאי לעיין בבעיות הקיימות בספרייה הזו. כדי להצביע על בעיה קיימת, לוחצים על לחצן הכוכב.

דיווח על בעיה חדשה

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

גירסה 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.
  • שיטות של תוספים להודעות חזרה (callbacks) של 'חשיפה מרחבית' שנוספו כדי לעקוב אחרי הרגעים שבהם תוכן הסצנה נכנס או יוצא מטווח הראייה של המשתמש.
  • נוספה גרסה של סטאב ל-JxrPlatformAdapter (וכל הכיתות הקשורות אליו).
  • המערכת תשתמש ב-Session גם ב-SceneCore וגם בסביבת זמן הריצה, במקום ב-Session ב-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 יש וריאציות שונות (למשל runtime-openxr או runtime-testing) בהתאם לפלטפורמת הביצוע. בנוסף, הספרייה הזו מציעה הפשטות מתמטיות בסיסיות כמו Vector3 ו-Matrix4, שמשמשות בכל פני השטח של Jetpack XR API.

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

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

בעיות מוכרות

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