ضبط جلسة ARCore باستخدام إضافات ARCore لـ Unity
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك إعداد جلسة ARCore لإنشاء تجارب واقع معزّز لتطبيقك.
ما المقصود بالجلسة؟
تحدث جميع عمليات الواقع المعزّز، مثل تتبُّع الحركة،
وفهم البيئة، وتقدير الإضاءة، داخل جلسة ARCore. ARSession هي نقطة الدخول الرئيسية إلى واجهة برمجة تطبيقات ARCore. ويدير هذا السطح حالة نظام الواقع المعزّز ويعالج دورة حياة الجلسة، ما يسمح
للتطبيق بإنشاء جلسة أو ضبطها أو بدؤها أو إيقافها. والأهم من ذلك، هو أنّه
يتيح للتطبيق تلقّي لقطات تتيح الوصول إلى صورة الكاميرا و
وضع الجهاز.
يمكن استخدام الجلسة لضبط الميزات التالية:
إعداد AR Foundation وإضافات ARCore
يجب إعداد AR Foundation قبل أن تتمكّن من استخدام "إضافات ARCore". اطّلِع على مستندات إعداد AR Foundation للحصول على تعليمات حول إعداد مشهد الواقع المعزّز.
يجب إعداد "إضافات ARCore" قبل أن تتمكّن من ضبط جلسة ARCore. اطّلِع على مستندات إعداد "إضافات ARCore" إذا لم يسبق لك ذلك.
أنشئ إعداد جلسة جديدًا في ARCore.
في Unity، أنشئ إعداد جلسة جديدًا من خلال الانتقال إلى Assets >
Create > XR > ARCore Extensions Config.
تظهر الإعدادات التلقائية على النحو التالي:
في لوحة Hierarchy، اختَر ARCore Extensions
العنصر.
في الحقل ARCore Extensions Config في لوحة Inspector،
انقر على زر الوجهة
، واربط بالعنصرARCoreExtensionsConfig.
إدارة جلسات الواقع المعزّز
في الإصدارَين 2.1
و3.1 من AR Foundation، سيؤدي تدمير عنصر لعبة ARSession إلى تدمير جلسة ARCore الأساسية.
بدءًا من الإصدار 4.0 من AR Foundation، يجب استخدام الدوالّ
LoaderUtility
لإلغاء الأنظمة الفرعية وإنشائها بدلاً من ذلك. اطّلِع على دليل نقل البيانات من الإصدار 3.x إلى الإصدار 4.x من AR Foundation.
الخطوات التالية
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)"]]
