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

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

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

אתם יכולים לקבוע את הזמינות של ה-VPS במיקום אופקי נתון לפני תחילת סשן ה-AR, ולהשתמש בה כדי ליצור חוויות ספציפיות יותר – לדוגמה, להציג את הלחצן 'כניסה ל-AR' רק כשה-VPS זמין.

הפעלת ה-API של ARCore

כדי לבדוק את הזמינות של 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(). אף שיחה חוזרת שתירשם לא תתבצע אף פעם.
• DONE: הפעולה הושלמה. משתמשים ב-VpsAvailabilityFuture.getResult() כדי לקבל את התוצאה.

אפשר להמשיך לבדוק את Future.getState() עד שהמשימה תושלם.

JavaKotlin

// 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, ...
  }
}

// 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, ...")
    }
  }
}

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

אפשר לקבל את התוצאה של Future גם באמצעות קריאה חוזרת. משתמשים ב-Session.checkVpsAvailabilityAsync() ומספקים callback. הפונקציה callback תיקרא בשרשור הראשי זמן קצר אחרי ש-Future יהיה במצב DONE.

JavaKotlin

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.
      }
    });

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 יספיק ליצירת תנוחה עם דיוק גבוה.

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

• קבלת תנוחת המיקום הגיאוגרפי של מצלמת המכשיר כדי לקבוע את המיקום המדויק של המכשיר של המשתמש בעולם האמיתי.