یک جلسه ARCore را در Android NDK پیکربندی کنید

یک جلسه ARCore را برای ایجاد تجربیات AR برای برنامه خود پیکربندی کنید.

جلسه چیست؟

تمام فرآیندهای واقعیت افزوده ، مانند ردیابی حرکت، درک محیطی، و برآورد نور، در یک جلسه ARCore اتفاق می‌افتند. ArSession نقطه ورود اصلی به ARCore API است. وضعیت سیستم AR را مدیریت می کند و چرخه عمر جلسه را مدیریت می کند و به برنامه اجازه می دهد یک جلسه را ایجاد، پیکربندی، شروع یا متوقف کند. مهمتر از همه، این برنامه را قادر می سازد تا فریم هایی را دریافت کند که امکان دسترسی به تصویر دوربین و ژست دستگاه را فراهم می کند.

از جلسه می توان برای پیکربندی ویژگی های زیر استفاده کرد:

• برآورد روشنایی
• لنگرهای ابری
• تصاویر افزوده شده
• چهره های تقویت شده
• Depth API
• قرار دادن فوری
• ARCore Geospatial API

بررسی کنید که ARCore نصب شده و به روز باشد

قبل از ایجاد یک ArSession ، بررسی کنید که ARCore نصب شده و به روز باشد. اگر ARCore نصب نشده باشد، ایجاد جلسه با شکست مواجه می شود و نصب یا ارتقاء بعدی ARCore به راه اندازی مجدد برنامه نیاز دارد.

/*
 * 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;
  }
}

یک جلسه ایجاد کنید

یک جلسه در ARCore ایجاد و پیکربندی کنید.

// 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);

یک جلسه را ببندید

ArSession دارای مقدار قابل توجهی از حافظه Heap بومی است. بسته نشدن صریح جلسه ممکن است باعث شود که حافظه اصلی برنامه شما تمام شود و از کار بیفتد. وقتی دیگر نیازی به جلسه AR نیست، ArSession_destroy() را برای انتشار منابع فراخوانی کنید.

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

مراحل بعدی

• شروع سریع ARCore برای Android NDK