Android NDK'da ARCore oturumu yapılandırın

Uygulamanızda artırılmış gerçeklik deneyimleri oluşturmak için bir ARCore oturumu yapılandırın.

Oturum nedir?

Hareket izleme, çevre anlama ve ışık tahmini gibi tüm AR işlemleri, bir ARCore oturumunda gerçekleştirilir. ArSession, ARCore API'sinin ana giriş noktasıdır. AR sistem durumunu yönetir ve oturum yaşam döngüsünü yürüterek uygulamanın oturum oluşturmasına, yapılandırmasına, başlatmasına veya durdurmasına olanak tanır. En önemlisi, uygulamanın kamera görüntüsüne ve cihaz pozuna erişime izin veren kareler almasını sağlar.

Oturum, aşağıdaki özellikleri yapılandırmak için kullanılabilir:

ARCore'un yüklü ve güncel olduğunu doğrulayın

ArSession oluşturmadan önce ARCore'un yüklü ve güncel olduğunu doğrulayın. ARCore yüklü değilse oturum oluşturma işlemi başarısız olur ve ARCore'un sonraki yükleme veya yükseltme işlemleri uygulamanın yeniden başlatılmasını gerektirir.

/*
 * Check if ARCore is currently usable, i.e. whether ARCore is supported and
 * up to date.
 */
int32_t is_arcore_supported_and_up_to_date(void* env, void* context) {
  ArAvailability availability;
  ArCoreApk_checkAvailability(env, context, &availability);
  switch (availability) {
    case AR_AVAILABILITY_SUPPORTED_INSTALLED:
      return true;
    case AR_AVAILABILITY_SUPPORTED_APK_TOO_OLD:
    case AR_AVAILABILITY_SUPPORTED_NOT_INSTALLED: {
      ArInstallStatus install_status;
      // ArCoreApk_requestInstall is processed asynchronously.
      CHECK(ArCoreApk_requestInstall(env, context, true, &install_status) ==
            AR_SUCCESS);
      return false;
    }
    case AR_AVAILABILITY_UNSUPPORTED_DEVICE_NOT_CAPABLE:
      // This device is not supported for AR.
      return false;
    case AR_AVAILABILITY_UNKNOWN_CHECKING:
      // ARCore is checking the availability with a remote query.
      // This function should be called again after waiting 200 ms
      // to determine the query result.
      handle_check_later();
      return false;
    case AR_AVAILABILITY_UNKNOWN_ERROR:
    case AR_AVAILABILITY_UNKNOWN_TIMED_OUT:
      // There was an error checking for AR availability.
      // This may be due to the device being offline.
      // Handle the error appropriately.
      handle_unknown_error();
      return false;

    default:  // All enum cases have been handled.
      return false;
  }
}

Oturum oluştur

ARCore'da oturum oluşturun ve yapılandırın.

// Create a new ARCore session.
ArSession* ar_session = NULL;
CHECK(ArSession_create(env, context, &ar_session) == AR_SUCCESS);

// Create a session config.
ArConfig* ar_config = NULL;
ArConfig_create(ar_session, &ar_config);

// Do feature-specific operations here, such as enabling depth or turning on
// support for Augmented Faces.

// Configure the session.
CHECK(ArSession_configure(ar_session, ar_config) == AR_SUCCESS);

Oturum kapatma

ArSession, önemli miktarda yerel yığın belleğine sahip. Oturumun açık bir şekilde kapatılmaması uygulamanızın yerel belleğinin tükenmesine ve kilitlenmesine neden olabilir. AR oturumuna artık ihtiyaç duyulmadığında, kaynakları serbest bırakmak için ArSession_destroy() numaralı telefonu arayın.

// Release memory used by the AR session.
ArSession_destroy(session);

Sonraki adımlar