ARCore for Jetpack XR מספק לאפליקציה יכולות תפיסה מתקדמות כדי להבין את העולם האמיתי באמצעות מגוון ממשקי API. חלק מהממשקי ה-API האלה עוזרים לשפר חוויות סוחפות במכשירים כמו אוזניות XR ומשקפי XR חוטיים, חלק עוזרים לשפר חוויות מציאות רבודה במכשירים כמו משקפי AI, וחלק עוזרים לשפר חוויות באפליקציות בכל סוגי מכשירי Android XR.
לדוגמה, אפשר להשתמש ב-ARCore for 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, צריך ליצור אותו:
כדי ליצור סשן, מעבירים פעילות למתודה create(), כמו בדוגמה הבאה:
when (val result = Session.create(this)) { 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 for Jetpack XR
- אחזור נתוני עומק באפליקציה באמצעות ARCore for Jetpack XR
- מעקב אחרי תנוחת המכשיר באמצעות ARCore for Jetpack XR
- עבודה עם מיקומים גיאו-מרחביים באמצעות ARCore for Jetpack XR