設定 ARCore 工作階段,為您的應用程式打造 AR 體驗。
什麼是工作階段?
所有 AR 程序,例如動作追蹤
透過 ARCore 技術瞭解環境知識,以及估算亮度
會很有幫助ArSession
是 ARCore 的主要進入點
也能使用 Google Cloud CLI 或
Compute Engine 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);