Unity용 ARCore 확장 프로그램으로 ARCore 세션 구성
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
앱의 AR 환경을 빌드하도록 ARCore 세션을 구성합니다.
세션이란 무엇인가요?
모션 추적, 환경 인식, 조명 추정과 같은 모든 AR 프로세스는 ARCore 세션 내에서 실행됩니다. ARSession는 ARCore API의 기본 진입점입니다. AR 시스템 상태를 관리하고 세션 수명 주기를 처리하여 앱이 세션을 만들거나, 구성하거나, 시작하거나, 중지할 수 있도록 합니다. 가장 중요한 점은 앱이 카메라 이미지 및 기기 포즈에 액세스할 수 있는 프레임을 수신할 수 있다는 것입니다.
세션을 사용하여 다음 기능을 구성할 수 있습니다.
AR Foundation 및 ARCore 확장 프로그램 설정
ARCore 확장 프로그램을 사용하려면 먼저 AR Foundation을 설정해야 합니다. AR 장면 설정에 관한 안내는 AR Foundation 설정 문서를 참고하세요.
ARCore 세션을 구성하려면 먼저 ARCore 확장 프로그램을 설정해야 합니다. 아직 설정하지 않았다면 ARCore 확장 프로그램 설정 문서를 참고하세요.
ARCore에서 새 세션 구성을 만듭니다.
Unity에서 Assets >
Create > XR > ARCore Extensions Config로 이동하여 새 세션 구성을 만듭니다.
기본 구성은 다음과 같습니다.
Hierarchy 창에서 ARCore Extensions 객체를 선택합니다.
Inspector 창의 ARCore Extensions Config 필드에서 타겟 
버튼을 클릭하고 ARCoreExtensionsConfig 애셋에 연결합니다.
AR 세션 관리
AR Foundation 2.1 및 3.1에서 ARSession 게임 객체를 삭제하면 기본 ARCore 세션이 삭제됩니다.
AR Foundation 4.0부터는 LoaderUtility 함수를 사용하여 대신 하위 시스템을 소멸하고 만들 수 있습니다. AR Foundation 3.x에서 4.x로의 이전 가이드를 참고하세요.
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eAn ARCore session manages all AR processes like motion tracking and environmental understanding, and is accessed through the \u003ccode\u003eARSession\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eBefore configuring an ARCore session, ensure both AR Foundation and ARCore Extensions are properly set up in your Unity project.\u003c/p\u003e\n"],["\u003cp\u003eYou can configure extension features within the ARCoreExtensionsConfig asset, which allows you to customize session behavior.\u003c/p\u003e\n"],["\u003cp\u003eStarting with AR Foundation 4.0, session management is handled through \u003ccode\u003eLoaderUtility\u003c/code\u003e functions instead of destroying the \u003ccode\u003eARSession\u003c/code\u003e game object.\u003c/p\u003e\n"],["\u003cp\u003eAfter configuring your session, explore the provided quickstart guides for Android and iOS to begin building AR experiences with ARCore Extensions.\u003c/p\u003e\n"]]],["An ARCore session is essential for AR processes like motion tracking and lighting estimation. `ARSession` manages the AR system state, including session creation and configuration, and enables access to camera images and device pose. Before configuring the ARCore session, AR Foundation and ARCore Extensions must be set up. You need to create an `ARCore Extensions Config` asset in Unity and connect it to the `ARCore Extensions` object. Session management is done using `LoaderUtility` functions in newer versions of AR Foundation.\n"],null,["# Configure an ARCore session with ARCore Extensions for Unity\n\nConfigure an ARCore session to build AR experiences for your app.\n\nWhat is a session?\n------------------\n\nAll [AR processes](/ar/discover/concepts), such as motion tracking,\nenvironmental understanding, and lighting estimation, happen inside an ARCore\nsession. [`ARSession`](https://docs.unity3d.com/Packages/com.unity.xr.arfoundation@4.1/api/UnityEngine.XR.ARFoundation.ARSession.html) is the main entry point to the ARCore\nAPI. It manages the AR system state and handles the session lifecycle, allowing\nthe app to create, configure, start, or stop a session. Most importantly, it\nenables the app to receive frames that allow access to the camera image and\ndevice pose.\n\nThe session can be used to configure the following features:\n\n- [Cloud Anchors](/ar/develop/cloud-anchors)\n- [ARCore Geospatial API](/ar/develop/geospatial)\n\nSet up AR Foundation and ARCore Extensions\n------------------------------------------\n\nAR Foundation must be set up before you can use ARCore Extensions. See the\n[AR Foundation setup documentation](https://docs.unity3d.com/Packages/com.unity.xr.arfoundation@4.1/manual/index.html#scene-setup)\nfor instructions for setting up your AR scene.\n\nARCore Extensions must be set up before you can configure an ARCore session. See\nthe\n[ARCore Extensions setup documentation](/ar/develop/unity-arf/getting-started-extensions#setup_arcore_extensions) if you have not done so already.\n\nConfigure extension features in ARCoreExtensionsConfig\n------------------------------------------------------\n\nCreate a new session configuration in ARCore.\n\n1. In Unity, create a new session configuration by navigating to **Assets \\\u003e\n Create \\\u003e XR \\\u003e ARCore Extensions Config**.\n\n The default configuration looks like this:\n\n2. In the **Hierarchy** pane, select the **ARCore Extensions**\n object.\n\n3. In the **Inspector** pane's **ARCore Extensions Config** field,\n click the target\n\n button, and connect to the **ARCoreExtensionsConfig**\n asset.\n\nAR Session management\n---------------------\n\nIn [AR Foundation](https://docs.unity3d.com/Packages/com.unity.xr.arfoundation@4.2/manual) 2.1\nand 3.1 destroying the **ARSession** game object would destroy the underlying\nARCore session.\n\nStarting with AR Foundation 4.0, you must use the\n[`LoaderUtility`](https://docs.unity3d.com/Packages/com.unity.xr.arfoundation@4.2/api/UnityEngine.XR.ARFoundation.LoaderUtility.html)\nfunctions to destroy and create subsystems instead. See the AR Foundation\n[3.x to 4.x migration guide](https://docs.unity3d.com/Packages/com.unity.xr.arfoundation@4.1/manual/migration-guide-3.html).\n\n- [`LoaderUtility.Deinitialize()`](https://docs.unity3d.com/Packages/com.unity.xr.arfoundation@4.2/api/UnityEngine.XR.ARFoundation.LoaderUtility.html#UnityEngine_XR_ARFoundation_LoaderUtility_Deinitialize)\n- [`LoaderUtility.Initialize()`](https://docs.unity3d.com/Packages/com.unity.xr.arfoundation@4.2/api/UnityEngine.XR.ARFoundation.LoaderUtility.html#UnityEngine_XR_ARFoundation_LoaderUtility_Initialize)\n\nNext steps\n----------\n\n- [Quickstart for ARCore Extensions for Android](/ar/develop/unity-arf/quickstart-android)\n- [Quickstart for ARCore Extensions for iOS](/ar/develop/unity-arf/quickstart-ios)"]]
