لوحة أداء ARCore المركّبة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكن أن تعرض ARCore لوحة متراكبة مع إحصاءات أداء التطبيق، مثل
وحدة المعالجة المركزية واستخدام الذاكرة، ما يوفّر نظرة عامة في الوقت الفعلي على موارد النظام
اتّبِع الخطوات التالية لتفعيل "تراكب الأداء".
افتح تجربة الواقع المعزّز في تطبيقك لتكون جلسة ARCore نشطة.
الجري. يجب أن يكون تطبيقك في وضع الواقع المعزّز لتلقّي البث الذي يُفعّل
من سطح الصفحة يجب أن تكون صور معاينة كاميرا الواقع المعزّز مرئية على الجهاز.
الشاشة.
استخدم أمر بث مدير النشاط التالي لتفعيل
تراكب الأداء لتطبيقك.
# Enables ARCore's performance overlay and saves a setting to your app's
# Android Shared Preferences, so that the overlay remains enabled in
# subsequent ARCore sessions.
# Your app must have an actively running ARCore session to receive the broadcast.
adb shell am broadcast -a com.google.ar.core.ENABLE_PERFORMANCE_OVERLAY
قد يتم توجيهك إلى قائمة Settings لمنح حزمة ARCore.
إذن برسم التراكبات. يجب تنفيذ هذه الخطوة مرة واحدة فقط. البحث
Google Play Services for AR وضبط خيار تبديل الأذونات على Allowed
قبل الرجوع إلى التطبيق
في حال تفعيل "تراكب الأداء" بدون منح ARCore
إذن لرسم تراكبات، سيتم توجيهك إلى قائمة الإعدادات كل منها
مرة يبدأ فيها التطبيق جلسة جديدة على ARCore. في هذه الحالة، ينبغي لك
منح ARCore إذنًا، أو إيقاف المحتوى المركّب على الأداء.
اتّبِع الخطوات التالية لإيقاف الأداء المركّب.
افتح تجربة الواقع المعزّز في تطبيقك لتكون جلسة ARCore نشطة.
الجري. يجب أن يكون تطبيقك في وضع الواقع المعزّز لتلقّي البث الذي يتم إيقافه.
من سطح الصفحة يجب أن تكون صور معاينة كاميرا الواقع المعزّز مرئية على الجهاز.
الشاشة.
استخدم أمر بث مدير النشاط التالي لتعطيل
تراكب الأداء لتطبيقك.
# Disables ARCore's performance overlay and saves a setting to your app's
# Android Shared Preferences, so that the overlay remains disabled in
# subsequent ARCore sessions.
# Your app must have an actively running ARCore session to receive the broadcast.
adb shell am broadcast -a com.google.ar.core.DISABLE_PERFORMANCE_OVERLAY
يمكنك أيضًا إيقاف الأداء المركّب من خلال النقر على زر الإغلاق.
على التراكب والمحو
الإعدادات المفضّلة المشتركة في Android لتطبيقك. ويمكنك إجراء ذلك من خلال محو بيانات
البيانات.
تفسير قيم استخدام وحدة المعالجة المركزية (CPU)
يعرض الحقل Process CPU Usage مقدار الوقت الذي تستغرقه وحدة المعالجة المركزية (CPU)
التي تستخدمها عملية التطبيقات حاليًا كنسبة مئوية من إجمالي عدد الأجهزة
وقت وحدة المعالجة المركزية المتاح. تتضمن هذه القيمة أعباء عمل التطبيقات وأعباء عمل ARCore
وأي مكتبات أخرى يستخدمها تطبيقك على سبيل المثال، سيعرض الحقل
استخدام وحدة معالجة مركزية بنسبة% 25 في حال تشبّع معالجة التطبيق بوحدة معالجة مركزية واحدة بالكامل عند
يعمل على جهاز رباعي النواة.
يعرض تراكب الأداء أيضًا تفاصيل استخدام وحدة المعالجة المركزية (CPU) للاستخدام الفردي
ميزات ARCore. ويتم التعبير عن هذه التقسيمات أيضًا كنسبة مئوية من
إجمالي وقت وحدة المعالجة المركزية المتاح للجهاز. أعباء العمل هي:
لا يعرض التراكب أي ميزات معطلة أو تستخدم أقل من
وقت وحدة المعالجة المركزية (CPU) بنسبة 0.1%.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eARCore offers a performance overlay that displays real-time CPU and memory usage statistics for your app during AR experiences.\u003c/p\u003e\n"],["\u003cp\u003eTo enable or disable the overlay, use specific ADB commands while your app is actively running in AR mode.\u003c/p\u003e\n"],["\u003cp\u003eThe overlay requires permission to draw overlays, which can be granted in the device's settings for "Google Play Services for AR".\u003c/p\u003e\n"],["\u003cp\u003eCPU usage is shown as a percentage of total device CPU, including both app and ARCore processes, and further broken down by specific ARCore features like motion tracking and plane detection.\u003c/p\u003e\n"]]],[],null,["# ARCore performance overlay\n\nARCore can display an overlay panel with an app's performance statistics such as\nCPU and memory usage, providing a real-time overview of system resources.\n\nEnable the performance overlay\n------------------------------\n\nFollow these steps to enable the performance overlay.\n\n1. Open the AR experience in your app so that there is an active ARCore session\n running. **Your app must be in AR mode to receive the broadcast that enables\n the overlay.** The AR camera preview images should be visible on the device\n screen.\n\n2. Use the following activity manager broadcast command to enable the\n performance overlay for your app.\n\n # Enables ARCore's performance overlay and saves a setting to your app's\n # Android Shared Preferences, so that the overlay remains enabled in\n # subsequent ARCore sessions.\n\n # Your app must have an actively running ARCore session to receive the broadcast.\n adb shell am broadcast -a com.google.ar.core.ENABLE_PERFORMANCE_OVERLAY\n\n3. You may be directed to the **Settings** menu to grant the ARCore package\n permission to draw overlays. This step only needs to be performed once. Find\n **Google Play Services for AR** and set the permissions toggle to **Allowed**\n before navigating back to your app.\n\n If you have enabled the performance overlay without granting ARCore\n permission to draw overlays, you will be directed to the Settings menu each\n time the app begins a new ARCore session. In this case, you should either\n grant ARCore permission, or disable the performance overlay.\n\nDisable the performance overlay\n-------------------------------\n\nFollow these steps to disable the performance overlay.\n\n1. Open the AR experience in your app so that there is an active ARCore session\n running. **Your app must be in AR mode to receive the broadcast that disables\n the overlay.** The AR camera preview images should be visible on the device\n screen.\n\n2. Use the following activity manager broadcast command to disable the\n performance overlay for your app.\n\n # Disables ARCore's performance overlay and saves a setting to your app's\n # Android Shared Preferences, so that the overlay remains disabled in\n # subsequent ARCore sessions.\n\n # Your app must have an actively running ARCore session to receive the broadcast.\n adb shell am broadcast -a com.google.ar.core.DISABLE_PERFORMANCE_OVERLAY\n\nYou can also disable the performance overlay by tapping the close button\non the overlay and clearing\nyour app's Android Shared Preferences. One way to do this is to clear your app's\ndata.\n\nInterpreting CPU usage values\n-----------------------------\n\nThe **Process CPU Usage** field displays the amount of CPU time that the\napplication process currently uses as a percentage of the device's total\navailable CPU time. This value includes application workloads, ARCore workloads,\nand any other libraries that your app uses. For example, the field would display\n25% CPU usage if the application process fully saturates a single CPU core when\nrunning on a quad-core device.\n\nThe performance overlay also provides a CPU usage breakdown for individual\nARCore features. These breakdowns are also expressed as a percentage of the\ndevice's total available CPU time. The workloads are:\n\n- [Motion Tracking](/ar/discover/concepts#motion_tracking)\n- [Plane Detection](/ar/discover/concepts#environmental_understanding)\n\nThe overlay does not display any features that are disabled or using less than\n0.1% CPU time."]]
