Nakładka skuteczności ARCore

ARCore może wyświetlać panel ze statystykami wydajności aplikacji, takimi jak wykorzystanie procesora i pamięci, udostępniając w czasie rzeczywistym przegląd zasobów systemowych.

Włącz nakładkę skuteczności

Aby włączyć nakładkę skuteczności, wykonaj te czynności:

  1. Otwórz środowisko AR w aplikacji, aby uruchomić aktywną sesję ARCore. Aplikacja musi być w trybie AR, aby odbierać transmisję umożliwiającą włączenie nakładki. Obrazy podglądu aparatu w trybie AR powinny być widoczne na ekranie urządzenia.

  2. Aby włączyć nakładkę wydajności w aplikacji, użyj poniższego polecenia przesyłania w Menedżerze aktywności.

    # 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. Możesz przejść do menu Settings, aby przyznać pakietowi ARCore uprawnienia do wyświetlania nakładek. Tę czynność trzeba wykonać tylko raz. Zanim wrócisz do aplikacji, znajdź opcję Google Play Services for AR i ustaw przełącznik uprawnień na Allowed.

    Jeśli włączysz nakładkę wydajności, nie przyznając ARCore uprawnień do rysowania nakładek, nastąpi przekierowanie do menu Ustawienia za każdym razem, gdy aplikacja rozpocznie nową sesję ARCore. W takim przypadku przyznaj uprawnienia ARCore lub wyłącz nakładkę wydajności.

Wyłącz nakładkę skuteczności

Aby wyłączyć nakładkę skuteczności, wykonaj te czynności:

  1. Otwórz środowisko AR w aplikacji, aby uruchomić aktywną sesję ARCore. Aplikacja musi być w trybie AR, aby odbierać transmisję wyłączającą nakładkę. Obrazy podglądu aparatu w trybie AR powinny być widoczne na ekranie urządzenia.

  2. Aby wyłączyć nakładkę wydajności w swojej aplikacji, użyj poniższego polecenia przesyłania w Menedżerze aktywności.

    # 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

Nakładkę wydajności możesz też wyłączyć, klikając przycisk zamykania na nakładce i usuwając ustawienia udostępnione w Androidzie aplikacji. Możesz to zrobić na przykład przez wyczyszczenie danych aplikacji.

Interpretowanie wartości wykorzystania procesora

Pole Process CPU Usage pokazuje czas pracy procesora wykorzystywany obecnie przez proces aplikacji jako odsetek całkowitego dostępnego czasu pracy procesora urządzenia. Ta wartość obejmuje zadania aplikacji, zadania ARCore i wszystkie inne biblioteki używane przez Twoją aplikację. Na przykład to pole wyświetla wykorzystanie procesora w 25%, jeśli proces aplikacji w pełni nasyci pojedynczy rdzeń procesora, gdy działa na urządzeniu czterordzeniowym.

Nakładka z informacjami o wydajności pokazuje też zestawienie wykorzystania procesora przez poszczególne funkcje ARCore. Te zestawienia są też wyrażone jako odsetek całkowitego dostępnego czasu pracy procesora na urządzeniu. Zadania to:

Nakładka nie wyświetla żadnych funkcji, które są wyłączone lub które wykorzystują mniej niż 0,1% czasu pracy procesora.