Overlay performa ARCore
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
ARCore dapat menampilkan panel overlay dengan statistik performa aplikasi seperti
Penggunaan CPU dan memori, yang memberikan ringkasan real-time tentang resource sistem.
Ikuti langkah-langkah berikut untuk mengaktifkan overlay performa.
Buka pengalaman AR di aplikasi Anda agar ada sesi ARCore yang aktif
sedang berjalan. Aplikasi Anda harus berada dalam mode AR agar dapat menerima siaran yang memungkinkan
overlay. Gambar pratinjau kamera AR harus terlihat di perangkat
layar.
Gunakan perintah siaran pengelola aktivitas berikut untuk mengaktifkan
overlay performa untuk aplikasi Anda.
# 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
Anda mungkin diarahkan ke menu Settings untuk memberikan paket ARCore
izin untuk menarik overlay. Langkah ini hanya perlu dilakukan sekali. Mencari
Google Play Services for AR dan setel tombol izin ke Allowed
sebelum menavigasi kembali ke aplikasi Anda.
Jika Anda telah mengaktifkan overlay performa tanpa memberikan ARCore
izin untuk menggambar overlay, Anda akan diarahkan ke menu Setelan masing-masing
aplikasi memulai sesi ARCore baru. Dalam kasus ini, Anda harus
memberikan izin kepada ARCore, atau menonaktifkan overlay performa.
Ikuti langkah-langkah berikut untuk menonaktifkan overlay performa.
Buka pengalaman AR di aplikasi Anda agar ada sesi ARCore yang aktif
sedang berjalan. Aplikasi Anda harus berada dalam mode AR untuk menerima siaran yang dinonaktifkan
overlay. Gambar pratinjau kamera AR harus terlihat di perangkat
layar.
Gunakan perintah siaran pengelola aktivitas berikut untuk menonaktifkan
overlay performa untuk aplikasi Anda.
# 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
Anda juga dapat menonaktifkan overlay performa dengan mengetuk tombol tutup
pada overlay dan menghapus
Preferensi Bersama Android aplikasi Anda. Salah satu cara untuk melakukannya adalah dengan menghapus
layanan otomatis dan data skalabel.
Menafsirkan nilai penggunaan CPU
Kolom Process CPU Usage menampilkan jumlah waktu CPU yang
yang saat ini digunakan dalam
persentase dari total penggunaan perangkat
waktu CPU yang tersedia. Nilai ini mencakup beban kerja aplikasi, beban kerja ARCore,
dan pustaka lain yang digunakan aplikasi Anda. Misalnya, {i>field<i} akan menampilkan
25% penggunaan CPU jika proses aplikasi
sepenuhnya memenuhi satu core CPU tunggal saat
yang berjalan di perangkat quad-core.
Overlay performa juga menampilkan perincian penggunaan CPU untuk setiap
Fitur ARCore. Perincian ini juga dinyatakan sebagai persentase
total waktu CPU yang tersedia di perangkat. Workloadnya adalah:
Overlay tidak menampilkan fitur apa pun yang dinonaktifkan atau menggunakan kurang dari
0,1% waktu CPU.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-26 UTC."],[[["\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."]]
