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

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

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

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

Включите API ARCore

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

После включения 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);
}

Получить результат через обратный вызов

Вы также можете получить результат ArFuture через обратный вызов. Используйте ArSession_checkVpsAvailabilityAsync() и предоставьте callback . Этот callback будет вызван в основном потоке вскоре после того, как 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 может быть достаточно для определения позы с высокой точностью.

Что дальше