ב-Geospatial API, נעשה שימוש בשילוב של נתוני VPS ונתוני GPS כדי ליצור תנוחות גיאו-מרחביות ברמת דיוק גבוהה. אפשר להשתמש ב-API בכל מקום שבו המכשיר יכול לקבוע את המיקום שלו:
- באזורים שבהם ה-GPS ברמת דיוק נמוכה, כמו מרחבים פנימיים וסביבות עירוניות צפופות, ה-API יסתמך על כיסוי ה-VPS כדי ליצור תנוחות ברמת דיוק גבוהה.
- בסביבות חיצוניות שבהן יש מעט הפרעות מהתקורה או שאין בהן הפרעות כלשהן, יכול להיות שה-Geospatial API יוכל להשתמש בנתוני המיקום הזמינים ב-GPS כדי ליצור תנוחות גיאו-מרחביות ברמת דיוק גבוהה.
אפשר לקבוע את הזמינות של VPS במיקום אופקי לפני שהסשן ב-AR מתחיל, ולהשתמש בו כדי ליצור חוויות ספציפיות יותר. לדוגמה, כדי להציג לחצן 'כניסה ל-AR' רק כששירות VPS זמין.
הפעלת ARCore API
כדי לבדוק את הזמינות של VPS צריך להפעיל את ARCore API באפליקציה.
אחרי שמפעילים את ARCore API, אפשר לבדוק את הזמינות של VPS בלי:
Session
פעיל (לפני התקשרותSession.resume()
).- הגדרת
GeospatialMode
.
בדיקת הזמינות של VPS באפליקציה
ניתן להשתמש ב-Geospatial API בכל מקום שבו המכשיר יכול לקבוע את המיקום שלו. אם חוויית ה-AR שלכם תלויה בכיסוי של VPS, אתם יכולים להשתמש ב-Session.checkVpsAvailabilityAsync()
כדי לקבל VpsAvailabilityFuture
, משימה אסינכרונית שבודקת את הזמינות של שרתי ה-VPS במיקום אופקי נתון.
אחרי שמקבלים את VpsAvailabilityFuture
, אפשר לקבל את התוצאה באמצעות תשאול או באמצעות התקשרות חזרה.
סקרו את התוצאה
יש להשתמש ב-Future.getState()
כדי למצוא את המצב של Future
. יש שלושה מצבים שונים:
PENDING
: הפעולה עדיין לא הושלמה ולכן לא ידועה שום תוצאה.CANCELLED
: הפעולה בוטלה על ידיFuture.cancel()
. אף פעם לא תתבצע קריאה חוזרת (callback) שרשומה.DONE
: הפעולה הושלמה. משתמשים ב-VpsAvailabilityFuture.getResult()
כדי לקבל את התוצאה.
כדאי להמשיך לבדוק את Future.getState()
עד שהמשימה תושלם.
Java
// Obtain a VpsAvailabilityFuture and store it somewhere. VpsAvailabilityFuture future = session.checkVpsAvailabilityAsync(latitude, longitude, null); // Poll VpsAvailabilityFuture later, for example, in a render loop. if (future.getState() == FutureState.DONE) { switch (future.getResult()) { case AVAILABLE: // VPS is available at this location. break; case UNAVAILABLE: // VPS is unavailable at this location. break; case ERROR_NETWORK_CONNECTION: // The external service could not be reached due to a network connection error. break; // Handle other error states, e.g. ERROR_RESOURCE_EXHAUSTED, ERROR_INTERNAL, ... } }
Kotlin
// Obtain a VpsAvailabilityFuture and store it somewhere. val future = session.checkVpsAvailabilityAsync(latitude, longitude, null) // Poll VpsAvailabilityFuture later, for example, in a render loop. if (future.state == FutureState.DONE) { when (future.result) { VpsAvailability.AVAILABLE -> { // VPS is available at this location. } VpsAvailability.UNAVAILABLE -> { // VPS is unavailable at this location. } VpsAvailability.ERROR_NETWORK_CONNECTION -> { // The external service could not be reached due to a network connection error. } else -> { TODO("Handle other error states, e.g. ERROR_RESOURCE_EXHAUSTED, ERROR_INTERNAL, ...") } } }
קבלת התוצאה באמצעות קריאה חוזרת (callback)
אפשר גם לקבל את התוצאה של Future
באמצעות קריאה חוזרת (callback). משתמשים בפונקציה Session.checkVpsAvailabilityAsync()
ומציינים callback
. תתבצע קריאה לcallback
הזה ב-thread הראשי זמן קצר אחרי שהמצב של Future
יהיה DONE
.
Java
session.checkVpsAvailabilityAsync( latitude, longitude, result -> { // Callback is called on the Main thread. switch (result) { // Handle the VpsAvailability result as shown above. // For example, show UI that enables your AR view. } });
Kotlin
session.checkVpsAvailabilityAsync(latitude, longitude) { result -> // Callback is called on the Main thread. // Handle the VpsAvailability result as shown above. // For example, show UI that enables your AR view. TODO("Handle VpsAvailability " + result) }
ביטול Future
אפשר להשתמש ב-Future.cancel()
כדי לנסות לבטל את Future
. בגלל מקבילה בשרשור, יכול להיות שניסיון הביטול לא יצליח בפועל.
הפונקציה Future.cancel()
מחזירה true
אם הניסיון נכשל. אחרת, מוחזרת false
.
שימוש ב-Geospatial API ללא כיסוי VPS
ניתן להשתמש ב-Geospatial API גם באזורים שאין בהם כיסוי VPS. בסביבות בחוץ שבהן יש מעט הפרעות מתקורה או שאין בהן הפרעות ממבט-על, ייתכן שה-GPS יספיק כדי ליצור תנוחה ברמת דיוק גבוהה.
המאמרים הבאים
- נתוני התנוחה הגיאו-מרחבית של מצלמת המכשיר מאפשרת לקבוע את המיקום המדויק של המכשיר בעולם האמיתי.