שיפור חוויות באפליקציות באמצעות תפיסה עם ARCore for Jetpack XR

מכשירי XR שנתמכים
ההנחיות האלה יעזרו לכם ליצור חוויות למכשירי XR מהסוגים הבאים.
משקפי XR
משקפי XR עם חיבור קווי

‫ARCore for Jetpack XR מספק לאפליקציה יכולות תפיסה מתקדמות כדי להבין את העולם האמיתי באמצעות מגוון ממשקי API. חלק מהממשקי ה-API האלה עוזרים לשפר חוויות סוחפות במכשירים כמו משקפי XR ומשקפי XR עם חיבור קווי, חלק עוזרים לשפר חוויות מציאות רבודה במכשירים כמו משקפי AI, וחלק עוזרים לשפר חוויית השימוש באפליקציות בכל סוגי מכשירי Android XR.

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

הוספת תלות של הפרויקט בספריות

לפני שמתחילים להשתמש בתכונות התפיסה באפליקציית XR, צריך להוסיף את יחסי התלות הנדרשים, בהתאם לסוג חוויות האפליקציה שמשפרים באמצעות AR.

גישה לסשן

תכונות התפיסה ב-ARCore for Jetpack XR מסתמכות על Session, שמשתמש ב-Jetpack XR Runtime.

האופן שבו האפליקציה ניגשת להפעלה תלוי בסוגי חוויות האפליקציה שאתם משפרים באמצעות תכונות התפיסה:

גישה לסשן מ-Jetpack XR Runtime

כדי לגשת לסשן מ-Jetpack XR Runtime, צריך ליצור אותו:

כדי ליצור סשן, מעבירים Context אל ה-method‏ create(). הContext יכול להיות Activity במכשירי XR או במכשירים ניידים, או הקשר מוקרן.

יצירת סשן של ARCore יכולה להיות משימה יקרה, ולכן צריך לעבד אותה ברקע, כמו בדוגמה הבאה:

lifecycleScope.launch {
    when (val result = Session.create(context)) {
        is SessionCreateSuccess -> {
            val xrSession = result.session
            // ...
        }
        else ->
            TODO(/* A different unhandled exception was thrown. */)
    }
}

כשפעילות של סשן מסוים נמחקת, כל תוכן ה-AR שמשויך לסשן הזה נמחק, והסשן כבר לא תקף.

הגדרת סשן

יכול להיות שחלק מהתכונות מושבתות כברירת מחדל, וצריך להגדיר אותן כדי שהן יפעלו. כדי להגדיר סשן, משתמשים בפקודה configure() ומציינים את אפשרויות ההגדרה שנדרשות ל-Session. לפרטים על ההגדרה הנדרשת לתכונות שונות של AR, אפשר לעיין בדפים המתאימים לכל תכונת AR.

השלבים הבאים

אחרי שיוצרים סשן לאפליקציה, אפשר לבדוק איך אפשר להשתמש בו כדי לשפר את חוויית השימוש באפליקציה במכשירי XR שונים: