配置 ARCore 会话,为您的应用打造 AR 体验。
什么是会话?
所有 AR 流程(例如动作跟踪)
环境理解和光估测都是在 ARCore 内部执行的,
会话。ArSession
是 ARCore 的主要入口点
API。它管理 AR 系统状态和处理会话生命周期,
应用以创建、配置、启动或停止会话。最重要的是
使应用能够接收允许访问相机图像的帧
设备姿势。
该会话可用于配置以下功能:
验证 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
拥有大量原生堆内存。失败
明确关闭会话可能会导致应用耗尽原生内存并
崩溃。当不再需要 AR 会话时,请调用
ArSession_destroy()
释放资源
// Release memory used by the AR session. ArSession_destroy(session);