Overlay performa ARCore

ARCore dapat menampilkan panel overlay yang berisi statistik performa aplikasi seperti penggunaan CPU dan memori, yang memberikan ringkasan real-time tentang resource sistem.

Mengaktifkan overlay performa

Ikuti langkah-langkah berikut untuk mengaktifkan overlay performa.

  1. Buka pengalaman AR di aplikasi Anda sehingga ada sesi ARCore aktif yang sedang berjalan. Aplikasi Anda harus berada dalam mode AR untuk menerima siaran yang mengaktifkan overlay. Gambar pratinjau kamera AR akan terlihat di layar perangkat.

  2. 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

  3. Anda mungkin akan diarahkan ke menu Settings guna memberikan izin kepada paket ARCore untuk menggambar overlay. Langkah ini hanya perlu dilakukan sekali. Temukan 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 izin kepada ARCore untuk menggambar overlay, Anda akan diarahkan ke menu Setelan setiap kali aplikasi memulai sesi ARCore baru. Dalam hal ini, sebaiknya Anda memberikan izin ARCore, atau menonaktifkan overlay performa.

Menonaktifkan overlay performa

Ikuti langkah-langkah berikut untuk menonaktifkan overlay performa.

  1. Buka pengalaman AR di aplikasi Anda sehingga ada sesi ARCore aktif yang sedang berjalan. Aplikasi Anda harus berada dalam mode AR untuk menerima siaran yang menonaktifkan overlay. Gambar pratinjau kamera AR akan terlihat di layar perangkat.

  2. 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. Salah satu cara untuk melakukannya adalah dengan menghapus data aplikasi Anda.

Menafsirkan nilai penggunaan CPU

Kolom Process CPU Usage menampilkan jumlah waktu CPU yang saat ini digunakan oleh proses aplikasi sebagai persentase total waktu CPU perangkat yang tersedia. Nilai ini mencakup workload aplikasi, workload ARCore, dan library lain yang digunakan aplikasi Anda. Misalnya, kolom ini akan menampilkan 25% penggunaan CPU jika proses aplikasi mencapai satu core CPU sepenuhnya saat berjalan di perangkat quad core.

Overlay performa juga menyediakan perincian penggunaan CPU untuk setiap fitur ARCore. Perincian ini juga dinyatakan sebagai persentase total waktu CPU yang tersedia di perangkat. Workload tersebut adalah:

Overlay tidak menampilkan fitur apa pun yang dinonaktifkan atau menggunakan waktu CPU kurang dari 0,1%.