ב-Geospatial API נעשה שימוש בשילוב של נתוני VPS ו-GPS כדי ליצור תנוחות גיאוסטריות מדויקות במיוחד. אפשר להשתמש ב-API בכל מקום שבו המכשיר יכול לקבוע את המיקום שלו:
- באזורים שבהם רמת הדיוק של ה-GPS נמוכה, כמו מקומות סגורים וסביבות עירוניות צפופות, ה-API יתבסס על כיסוי VPS כדי ליצור תנוחות עם דיוק גבוה.
- בסביבות חוץ עם מעט או בלי חסימות מעל הראש, יכול להיות ש-Geospatial API יוכל להשתמש בנתוני המיקום הזמינים של ה-GPS כדי ליצור תנוחות גיאו-מרחביות ברמת דיוק גבוהה.
אתם יכולים לקבוע את הזמינות של ה-VPS במיקום אופקי נתון לפני תחילת סשן ה-AR, ולהשתמש בה כדי ליצור חוויות ספציפיות יותר – לדוגמה, להציג את הלחצן 'כניסה ל-AR' רק כשה-VPS זמין.
הפעלה של ARCore API
כדי לבדוק את הזמינות של VPS, צריך להפעיל את ARCore API באפליקציה.
בדיקת הזמינות של VPS באפליקציה
אפשר להשתמש ב-Geospatial API בכל מקום שבו המכשיר יכול לקבוע את המיקום שלו. אם חוויית ה-AR שלכם תלויה בזמינות של VPS, תוכלו להשתמש ב-AREarthManager.CheckVpsAvailabilityAsync() כדי לקבל VpsAvailabilityPromise, משימה אסינכררונית שבודקת את הזמינות של ה-VPS במיקום אופקי נתון.
אחרי קבלת VpsAvailabilityPromise, אפשר לקבל את התוצאה שלו באמצעות סקרים.
בודקים את התוצאה
משתמשים ב-VpsAvailabilityPromise.State כדי לקבל את המצב של InterruptiblePromise. יש שלושה מצבים שונים:
Pending: הפעולה עדיין לא הושלמה, ולכן אין תוצאה ידועה.Cancelled: הפעולה בוטלה על ידיVpsAvailabilityPromise.Cancel(). אף שיחה חוזרת שתירשם לא תתבצע אף פעם.Done: הפעולה הושלמה. כדי לקבל את התוצאה, משתמשים בפונקציהVpsAvailabilityPromise.Result.
אפשר להמשיך לבדוק את VpsAvailabilityPromise.State עד שהמשימה תושלם.
ביטול הInterruptiblePromise
אפשר ללחוץ על VpsAvailabilityPromise.Cancel() כדי לנסות לבטל את InterruptiblePromise. בגלל עיבוד מקבילי של חוטים, יכול להיות שניסיון הביטול לא יצליח בפועל.
שימוש ב-Geospatial API ללא כיסוי של VPS
אפשר להשתמש ב-Geospatial API גם באזורים שאין להם כיסוי של VPS. בסביבות חוץ עם מעט או בלי חסימות מעל הראש, יכול להיות ש-GPS יספיק ליצירת תנוחה עם דיוק גבוה.
המאמרים הבאים
- קבלת תנוחת המיקום הגיאוגרפי של מצלמת המכשיר כדי לקבוע את המיקום המדויק של המכשיר של המשתמש בעולם האמיתי.