ARCore for Jetpack XR מספק לאפליקציה יכולות תפיסה מתקדמות כדי להבין את העולם האמיתי באמצעות מגוון ממשקי API. חלק מהממשקי ה-API האלה עוזרים לשפר חוויות סוחפות במכשירים כמו אוזניות XR ומשקפי XR חוטיים, חלקם עוזרים לשפר חוויות מציאות רבודה במכשירים כמו משקפי AI, וחלקם עוזרים לשפר חוויות שימוש באפליקציות בכל סוגי מכשירי Android XR.
לדוגמה, אפשר להשתמש ב-ARCore ל-Jetpack XR כדי לאחזר נתונים מישוריים, לעגן תוכן למיקום קבוע במרחב או להשתמש במיקום גיאוגרפי כדי לעגן תוכן למיקום בעולם האמיתי.
הוספת תלות של הפרויקט בספריות
לפני שמתחילים להשתמש בתכונות התפיסה באפליקציית XR, צריך להוסיף את יחסי התלות הנדרשים, בהתאם לסוג חוויות האפליקציה שמשפרים באמצעות AR.
גישה לסשן
תכונות התפיסה ב-ARCore ל-Jetpack XR מסתמכות על Session, שמשתמש ב-Jetpack XR Runtime.
האופן שבו האפליקציה ניגשת להפעלה תלוי בסוגי חוויות האפליקציה שאתם משפרים באמצעות תכונות תפיסה:
- אם האפליקציה שלכם משפרת חוויות סוחפות באמצעות ממשק משתמש מרחבי באמצעות Jetpack Compose for XR, צריך לגשת לסשן מ-Jetpack Compose for XR.
- בכל מצב אחר, אפשר לגשת אל גישה לסשן מ-Jetpack XR Runtime, שמוסבר בקטע הבא בדף הזה.
גישה לסשן מ-Jetpack XR Runtime
כדי לגשת לסשן מ-Jetpack XR Runtime, צריך ליצור אותו:
כדי ליצור סשן, מעבירים [Context] לשיטה create()
הContext יכול להיות Activity במכשירי Immersive XR או במכשירים ניידים, או הקשר מוקרן.
יצירת סשן של ARCore יכולה להיות משימה יקרה, ולכן צריך לעבד אותה ברקע, כמו בדוגמה הבאה:
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 שונים:
- זיהוי מישורים באמצעות ARCore for Jetpack XR
- יצירת עוגנים באמצעות ARCore for Jetpack XR
- איך עובדים עם הידיים באמצעות ARCore for Jetpack XR
- שילוב מעקב אחר הבעות פנים באפליקציה באמצעות ARCore for Jetpack XR
- אחזור נתוני עומק באפליקציה באמצעות ARCore ל-Jetpack XR
- מעקב אחר תנוחת מכשיר באמצעות ARCore for Jetpack XR