בדיקת הזמינות של שרתי ה-VPS במיקום הנוכחי של המכשיר

ב-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, תוכלו להשתמש ב-GARSession#checkVPSAvailabilityAtCoordinate:completionHandler: כדי לקבל GARVPSAvailabilityFuture, משימה אסינכררונית שבודקת את הזמינות של ה-VPS במיקום אופקי נתון. אחרי שמקבלים את GARVPSAvailabilityFuture, אפשר לקבל את התוצאה שלו באמצעות סקרים או באמצעות קריאה חוזרת.

בודקים את התוצאה

משתמשים ב-GARFuture.state כדי לקבל את המצב של Future. יש שלושה מצבים שונים:

  • GARFutureStatePending: הפעולה עדיין לא הושלמה, ולכן אין תוצאה ידועה.
  • GARFutureStateCancelled: הפעולה בוטלה על ידי GARFuture#cancel. אף שיחה חוזרת שתירשם לא תתבצע אף פעם.
  • GARFutureStateDone: הפעולה הושלמה. משתמשים ב-GARVPSAvailabilityFuture.result כדי לקבל את התוצאה.

אפשר להמשיך לבדוק את GARFuture.state עד שהמשימה תושלם.

קבלת התוצאה באמצעות שיחה חוזרת

אפשר לקבל את התוצאה של Future גם באמצעות קריאה חוזרת. משתמשים ב-GARSession#checkVPSAvailabilityAtCoordinate:completionHandler: ומספקים completionHandler. הפונקציה completionHandler תיקרא בשרשור הראשי זמן קצר אחרי ש-Future יהיה במצב GARFutureStateDone.

ביטול הFuture

משתמשים ב-GARFuture#cancel כדי לנסות לבטל את ה-Future. בגלל עיבוד מקבילי של חוטים, יכול להיות שניסיון הביטול לא יצליח בפועל. הפונקציה GARFuture#cancel מחזירה את הערך YES אם הניסיון הזה הצליח, ואת הערך NO אם לא.

שימוש ב-Geospatial API ללא כיסוי של VPS

אפשר להשתמש ב-Geospatial API גם באזורים ללא כיסוי של VPS. בסביבות חוץ עם מעט או בלי חסימות מעל הראש, יכול להיות ש-GPS יספיק ליצירת תנוחה עם דיוק גבוה.

המאמרים הבאים