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

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

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

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

הפעלת ARCore API

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

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

בדיקת הזמינות של VPS באפליקציה

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

סקרו את התוצאה

יש להשתמש ב-ArFuture_getState() כדי למצוא את המצב של ArFuture. יש שלושה מצבים שונים:

כדאי להמשיך לבדוק את 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 יספיק כדי ליצור תנוחה ברמת דיוק גבוהה.

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