ב-Geospatial API, נעשה שימוש בשילוב של נתוני VPS ונתוני GPS כדי ליצור תנוחות גיאו-מרחביות ברמת דיוק גבוהה. אפשר להשתמש ב-API בכל מקום שבו המכשיר יכול לקבוע את המיקום שלו:
- באזורים שבהם ה-GPS ברמת דיוק נמוכה, כמו מרחבים פנימיים וסביבות עירוניות צפופות, ה-API יסתמך על כיסוי ה-VPS כדי ליצור תנוחות ברמת דיוק גבוהה.
- בסביבות חיצוניות שבהן יש מעט הפרעות מהתקורה או שאין בהן הפרעות כלשהן, יכול להיות שה-Geospatial API יוכל להשתמש בנתוני המיקום הזמינים ב-GPS כדי ליצור תנוחות גיאו-מרחביות ברמת דיוק גבוהה.
אפשר לקבוע את הזמינות של VPS במיקום אופקי לפני שהסשן ב-AR מתחיל, ולהשתמש בו כדי ליצור חוויות ספציפיות יותר. לדוגמה, כדי להציג לחצן 'כניסה ל-AR' רק כששירות VPS זמין.
הפעלת ARCore API
כדי לבדוק את הזמינות של VPS צריך להפעיל את ARCore API באפליקציה.
אחרי שמפעילים את ARCore API, אפשר לבדוק את הזמינות של VPS בלי:
ArSession
פעיל (לפני התקשרותArSession_resume()
).- הגדרת
ArGeospatialMode
.
בדיקת הזמינות של VPS באפליקציה
ניתן להשתמש ב-Geospatial API בכל מקום שבו המכשיר יכול לקבוע את המיקום שלו. אם חוויית ה-AR שלכם תלויה בכיסוי של VPS, אתם יכולים להשתמש ב-ArSession_checkVpsAvailabilityAsync()
כדי לקבל ArVpsAvailabilityFuture
, משימה אסינכרונית שבודקת את הזמינות של שרתי ה-VPS במיקום אופקי נתון.
אחרי שמקבלים את ArVpsAvailabilityFuture
, אפשר לקבל את התוצאה באמצעות תשאול או באמצעות התקשרות חזרה.
סקרו את התוצאה
יש להשתמש ב-ArFuture_getState()
כדי למצוא את המצב של ArFuture
. יש שלושה מצבים שונים:
AR_FUTURE_STATE_PENDING
: הפעולה עדיין לא הושלמה ולכן לא ידועה שום תוצאה.AR_FUTURE_STATE_CANCELLED
: הפעולה בוטלה על ידיArFuture_cancel()
. אף פעם לא תתבצע קריאה חוזרת (callback) שרשומה.AR_FUTURE_STATE_DONE
: הפעולה הושלמה. משתמשים ב-ArVpsAvailabilityFuture_getResult()
כדי לקבל את התוצאה.
כדאי להמשיך לבדוק את ArFuture_getState()
עד שהמשימה תושלם.
// Obtain a ArVpsAvailabilityFuture and store it somewhere. ArVpsAvailabilityFuture* future = NULL; CHECK(ArSession_checkVpsAvailabilityAsync(ar_session, latitude, longitude, NULL, NULL, &future) == AR_SUCCESS); // Poll ArVpsAvailabilityFuture later, for example, in a render loop. ArFutureState future_state = AR_FUTURE_STATE_PENDING; ArFuture_getState(ar_session, (ArFuture*)future, &future_state); if (future_state == AR_FUTURE_STATE_DONE) { ArVpsAvailability vps_availability = AR_VPS_AVAILABILITY_UNKNOWN; ArVpsAvailabilityFuture_getResult(ar_session, future, &vps_availability); switch (vps_availability) { case AR_VPS_AVAILABILITY_AVAILABLE: // VPS is available at this location. break; case AR_VPS_AVAILABILITY_UNAVAILABLE: // VPS is unavailable at this location. break; case AR_VPS_AVAILABILITY_ERROR_NETWORK_CONNECTION: // The external service could not be reached due to a network connection // error. break; // Handle other error states, e.g. // AR_VPS_AVAILABILITY_ERROR_RESOURCE_EXHAUSTED, // AR_VPS_AVAILABILITY_ERROR_INTERNAL, ... } ArFuture_release((ArFuture*)future); }
קבלת התוצאה באמצעות קריאה חוזרת (callback)
אפשר גם לקבל את התוצאה של ArFuture
באמצעות קריאה חוזרת (callback). משתמשים בפונקציה ArSession_checkVpsAvailabilityAsync()
ומציינים callback
. תתבצע קריאה לcallback
הזה ב-thread הראשי זמן קצר אחרי שהמצב של ArFuture
יהיה AR_FUTURE_STATE_DONE
.
void vps_availability_callback(void* context, ArVpsAvailability availability) { // Callback is called on the Main thread. // Handle the ArVpsAvailability result as shown above. // For example, show UI that enables your AR view. // It is a best practice to free `context` memory at the end of the callback. free(context); } void check_availability_with_callback(ArSession* ar_session, double latitude, double longitude) { ArVpsAvailabilityFuture* future = NULL; void* context = NULL; CHECK(ArSession_checkVpsAvailabilityAsync( ar_session, latitude, longitude, context, vps_availability_callback, &future) == AR_SUCCESS); }
ביטול ArFuture
אפשר להשתמש ב-ArFuture_cancel()
כדי לנסות לבטל את ArFuture
. בגלל מקבילה בשרשור, יכול להיות שניסיון הביטול לא יצליח בפועל.
הפונקציה ArFuture_cancel()
מחזירה 1
אם הניסיון נכשל. אחרת, מוחזרת 0
.
שימוש ב-Geospatial API ללא כיסוי VPS
ניתן להשתמש ב-Geospatial API גם באזורים שאין בהם כיסוי VPS. בסביבות בחוץ שבהן יש מעט הפרעות מתקורה או שאין בהן הפרעות ממבט-על, ייתכן שה-GPS יספיק כדי ליצור תנוחה ברמת דיוק גבוהה.
המאמרים הבאים
- נתוני התנוחה הגיאו-מרחבית של מצלמת המכשיר מאפשרת לקבוע את המיקום המדויק של המכשיר בעולם האמיתי.