ARCore 성능 오버레이

ARCore는 CPU 및 메모리 사용량과 같은 앱의 성능 통계와 함께 오버레이 패널을 표시하여 시스템 리소스의 실시간 개요를 제공합니다.

성능 오버레이 사용 설정

성능 오버레이를 사용 설정하려면 다음 단계를 따르세요.

  1. 활성 ARCore 세션이 실행되도록 앱에서 AR 환경을 엽니다. 오버레이를 사용 설정하는 브로드캐스트를 수신하려면 앱이 AR 모드에 있어야 합니다. AR 카메라 미리보기 이미지가 기기 화면에 표시되어야 합니다.

  2. 다음 활동 관리자 브로드캐스트 명령어를 사용하여 앱의 성능 오버레이를 사용 설정합니다.

    # 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. ARCore 패키지에 오버레이를 그리는 권한을 부여하기 위해 Settings 메뉴로 이동할 수도 있습니다. 이 단계는 한 번만 수행하면 됩니다. Google Play Services for AR을 찾아 권한 전환 버튼을 Allowed으로 설정한 후 앱으로 다시 이동하세요.

    ARCore에 오버레이 그리기 권한을 부여하지 않고 성능 오버레이를 사용 설정한 경우 앱이 새 ARCore 세션을 시작할 때마다 설정 메뉴로 이동합니다. 이 경우 ARCore 권한을 부여하거나 성능 오버레이를 사용 중지해야 합니다.

성능 오버레이 사용 중지

성능 오버레이를 사용 중지하려면 다음 단계를 따르세요.

  1. 활성 ARCore 세션이 실행되도록 앱에서 AR 환경을 엽니다. 오버레이를 사용 중지하는 브로드캐스트를 수신하려면 앱이 AR 모드에 있어야 합니다. AR 카메라 미리보기 이미지가 기기 화면에 표시되어야 합니다.

  2. 다음 활동 관리자 브로드캐스트 명령어를 사용하여 앱의 성능 오버레이를 사용 중지합니다.

    # 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 시간이 기기의 가용 총 CPU 시간 비율로 표시됩니다. 이 값에는 애플리케이션 워크로드, ARCore 워크로드, 앱에서 사용하는 기타 라이브러리가 포함됩니다. 예를 들어 쿼드 코어 기기에서 실행될 때 애플리케이션 프로세스가 단일 CPU 코어를 완전히 포화하면 필드에 25% 의 CPU 사용량이 표시됩니다.

성능 오버레이는 개별 ARCore 기능의 CPU 사용량 분석도 제공합니다. 이러한 분류는 기기의 사용 가능한 총 CPU 시간의 비율로도 표시됩니다. 워크로드는 다음과 같습니다.

오버레이는 사용 중지되었거나 CPU 시간이 0.1% 미만인 기능을 표시하지 않습니다.