ב-Geospatial API נעשה שימוש בשילוב של נתוני VPS ו-GPS כדי ליצור תנוחות גיאוסטריות מדויקות. אפשר להשתמש ב-API בכל מקום שבו המכשיר יכול לקבוע את המיקום שלו:
- באזורים שבהם רמת הדיוק של ה-GPS נמוכה, כמו מקומות סגורים וסביבות עירוניות צפופות, ה-API יתבסס על כיסוי VPS כדי ליצור תנוחות עם דיוק גבוה.
- בסביבות חוץ עם מעט או בלי חסימות מעל הראש, יכול להיות ש-Geospatial API יוכל להשתמש בנתוני מיקום GPS זמינים כדי ליצור תנוחות גיאוגרפיות במיקום מדויק.
אתם יכולים לקבוע את הזמינות של ה-VPS במיקום אופקי נתון לפני תחילת סשן ה-AR, ולהשתמש בה כדי ליצור חוויות ספציפיות יותר – לדוגמה, להציג את הלחצן 'כניסה ל-AR' רק כשה-VPS זמין.
הפעלת ה-API של ARCore
כדי לבדוק את הזמינות של 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 יספיק ליצירת תנוחה עם דיוק גבוה.
המאמרים הבאים
- קבלת תנוחת המיקום הגיאוגרפי של מצלמת המכשיר כדי לקבוע את המיקום המדויק של המכשיר של המשתמש בעולם האמיתי.