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

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

• אם האפליקציה שלכם משפרת חוויות סוחפות באמצעות ממשק משתמש מרחבי באמצעות Jetpack Compose for XR, גשו לסשן מ-Jetpack Compose for XR.
• בכל מצב אחר, אתם יכולים ליצור סשן באמצעות 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. */)
    }
}
Session.kt

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

הגדרת סשן

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

השלבים הבאים

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

• זיהוי משטחים באמצעות ARCore for Jetpack XR
• יצירת עוגנים באמצעות ARCore for Jetpack XR
• איך עובדים עם הידיים באמצעות ARCore for Jetpack XR
• איך משלבים מעקב אחר הבעות הפנים באפליקציה באמצעות ARCore for Jetpack XR
• איך לאחזר מידע על עומק באפליקציה באמצעות ARCore for Jetpack XR
• מעקב אחרי תנוחת המכשיר באמצעות ARCore for Jetpack XR