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

ב-Geo-Space API נעשה שימוש בשילוב של נתוני VPS ו-GPS כדי ליצור מיקומים גיאו-מרחביים ברמת דיוק גבוהה. ניתן להשתמש ב-API בכל מקום שבו המכשיר יכול לקבוע את המיקום שלו:

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

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

הפעלה של ARCore API

כדי לבדוק את הזמינות של VPS, האפליקציה צריכה להפעיל את ARCore API.

אחרי שמפעילים את ARCore API, אפשר לבדוק את הזמינות של VPS בלי:

בודקים את הזמינות של 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 באמצעות התקשרות חזרה. משתמשים ב-Session.checkVpsAvailabilityAsync() ומציינים callback. תתבצע קריאה אל callback הזה בשרשור הראשי זמן קצר אחרי שהמצב של 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.

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

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

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