Проверьте доступность VPS в текущем местоположении устройства

Geospatial API использует комбинацию данных VPS и GPS для создания высокоточных геопространственных поз. API можно использовать в любом месте, где устройство может определить свое местоположение:

• В районах с низкой точностью GPS, таких как закрытые помещения и плотная городская среда, API будет полагаться на покрытие VPS для создания высокоточных поз.
• На открытом воздухе с небольшим количеством препятствий или без них Geospatial API может использовать доступные данные о местоположении GPS для создания геопространственных поз с высокой точностью.

Вы можете определить доступность VPS в заданной горизонтальной позиции до начала сеанса AR и использовать ее для создания более конкретных возможностей — например, для отображения кнопки «Войти в AR» только тогда, когда VPS доступен.

Включите API ARCore

Ваше приложение должно включить API ARCore для проверки доступности VPS.

После включения 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() до тех пор, пока задача не будет завершена.

Ява

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

Ява

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 может быть достаточно для определения позы с высокой точностью.

Что дальше

• Получите геопространственную позу камеры устройства , чтобы определить точное местоположение устройства пользователя в реальном мире.