ضبط جلسة 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-02-28 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-02-28 (حسب التوقيت العالمي المتفَّق عليه)"],[[["An ARCore session manages all AR processes like motion tracking and environmental understanding, and is accessed through the `ARSession` object."],["Before configuring an ARCore session, ensure both AR Foundation and ARCore Extensions are properly set up in your Unity project."],["You can configure extension features within the ARCoreExtensionsConfig asset, which allows you to customize session behavior."],["Starting with AR Foundation 4.0, session management is handled through `LoaderUtility` functions instead of destroying the `ARSession` game object."],["After configuring your session, explore the provided quickstart guides for Android and iOS to begin building AR experiences with ARCore Extensions."]]],["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"]]