느린 세션 (게임만 해당)

느린 세션은 Google Play Console의 새로운 Android vitals 측정항목입니다. 느린 세션은 프레임의 25% 이상이 느린 세션입니다. 이전 프레임보다 50ms 미만으로 표시되지 않으면 프레임 속도가 느린 것입니다(20FPS와 같음). Android vitals는 34밀리초 (30FPS에 해당) 타겟으로 두 번째 느린 세션 측정항목도 보고합니다. 느린 세션을 사용하면 게임의 프레임 속도 성능을 파악할 수 있으며, 이는 게임이 사용자에게 얼마나 매끄럽고 원활하게 진행되는지에 영향을 미칩니다.

앞으로 Play는 사용자가 휴대전화에서 20FPS를 달성하지 못하는 게임은 피하도록 할 것입니다. Android vitals는 게임이 1분 동안 실행된 후에만 프레임 속도 모니터링을 시작합니다.

측정항목에 대한 자세한 내용은 고객센터를 참조하세요.

느린 프레임과 느린 프레임의 수를 보여주는 원형 차트와 유사한 그래픽입니다.
그림 1. Android vitals의 느린 세션

FPS를 측정하고 느린 프레임을 감지하는 방법

Android dumpsys surfaceflinger timestats 명령어는 렌더링되는 모든 레이어에 평균 FPS와 표시에서 제시 시간 히스토그램을 제공합니다. 프레임의 현재까지의 현재 시간은 현재 프레임과 그려진 이전 프레임 사이의 간격입니다. 다음은 명령어를 사용하여 게임의 FPS를 수집하는 단계별 단계입니다.

  1. enableclear 플래그가 지정된 명령어를 실행하여 정보 캡처를 시작합니다.

    adb shell dumpsys SurfaceFlinger --timestats -clear -enable
    
  2. 게임이 충분히 오래 플레이되면 dump 플래그를 사용하여 명령어를 다시 실행하여 정보를 덤프합니다.

    adb shell dumpsys SurfaceFlinger --timestats -dump
    

    덤프된 정보는 SurfaceFlinger에서 렌더링된 모든 레이어의 총 프레임 및 presentToPresent 히스토그램을 제공합니다. layerName를 기반으로 필터링하여 게임의 섹션을 찾아야 합니다.

    layerName = SurfaceView[com.google.test/com.devrel.MainActivity]@0(BLAST)#132833
    

    세션의 느린 프레임 속도는 각 레이어의 정보를 기반으로 계산될 수 있습니다.

    예: 20FPS 느린 프레임 비율 = (54ms~1, 000ms 값의 합계) / totalFrames x 100

    totalFrames = 274
    ...
    presentToPresent histogram is as below:
    0ms=0 1ms=0 2ms=0 3ms=0 4ms=0 5ms=0 6ms=0 7ms=0 8ms=0 9ms=0 10ms=0 11ms=0 12ms=0
    13ms=0 14ms=0 15ms=0 16ms=1 17ms=0 18ms=0 19ms=0 20ms=0 21ms=0 22ms=0 23ms=0
    24ms=0 25ms=0 26ms=0 27ms=0 28ms=0 29ms=0 30ms=0 31ms=0 32ms=0 33ms=269 34ms=0
    36ms=0 38ms=0 40ms=0 42ms=0 44ms=0 46ms=0 48ms=0 50ms=1 54ms=0 58ms=0 62ms=0
    66ms=0 70ms=1 74ms=0 78ms=0 82ms=0 86ms=0 90ms=0 94ms=0 98ms=0 102ms=0 106ms=0
    110ms=0 114ms=0 118ms=0 122ms=0 126ms=0 130ms=0 134ms=0 138ms=0 142ms=0 146ms=0
    150ms=0 200ms=0 250ms=0 300ms=0 350ms=0 400ms=0 450ms=0 500ms=0 550ms=0 600ms=0
    650ms=0 700ms=0 750ms=0 800ms=0 850ms=0 900ms=0 950ms=0 1000ms=0
    

    각 레이어의 평균 FPS도 덤프에 표시됩니다.

    ...
    averageFPS = 30.179
    ...
    
  3. 모든 정보를 수집한 후에는 disable 플래그를 사용하여 timestats를 사용 중지해야 합니다.

    adb shell dumpsys SurfaceFlinger --timestats -disable
    

느린 프레임의 원인과 해결 방법

여러 가지 이유로 프레임이 표시되거나 화면에서 개발자의 타겟보다 더 오래 렌더링될 수 있습니다. 게임이 CPU/GPU 바운드일 수 있습니다. 또는 기기가 과열되어 제한된 열 상태를 활성화합니다. 또는 게임의 프레임 속도와 기기의 화면 새로고침 빈도가 일치하지 않을 수 있습니다.

Android Frame Pacing (Swappy), Vulkan, ADPF를 사용하여 이러한 문제를 해결하고 게임 성능을 개선하세요.

Swappy란 무엇인가요?

Swappy라고도 하는 Android 프레임 페이싱 라이브러리는 AGDK 라이브러리의 일부입니다. Swappy는 OpenGL 및 Vulkan 게임이 Android에서 원활한 렌더링 및 올바른 프레임 페이싱을 달성할 수 있도록 도와줍니다.

프레임 페이싱은 게임의 로직 및 렌더링 루프를 OS의 디스플레이 하위 시스템 및 기본 디스플레이 하드웨어와 동기화하는 것입니다. Android 디스플레이 하위 시스템은 디스플레이 하드웨어가 업데이트 도중에 새 프레임으로 전환될 때 발생할 수 있는 시각적 아티팩트 (테어링)를 방지하도록 설계되었습니다. 이러한 아티팩트를 방지하기 위해 디스플레이 하위 시스템은 다음을 실행합니다.

  • 지나간 프레임을 내부적으로 버퍼링
  • 늦은 프레임 제출 감지
  • 늦은 프레임 감지 시 지나간 프레임 표시 반복

네이티브 프로젝트에서 Swappy를 사용하는 방법

Android Frame Pacing 라이브러리를 게임에 통합하려면 다음 가이드를 참고하세요.

Unity 게임 엔진에서 Swappy를 사용하는 방법

Unity는 Android Frame Pacing을 엔진에 통합했습니다. Unity 2019.2 이상에서 이 기능을 사용 설정하려면 Android > Resolution and Presentation에서 Project Settings > Player > Settings 아래의 Optimized Frame Pacing 체크박스를 선택합니다.

프로젝트 설정 대화상자
그림 2. Unity Engine에서 프레임 페이싱을 사용 설정합니다.

또는 로직 코드에 Optimized Frame Pacing(최적화된 프레임 속도) 옵션을 프로그래매틱 방식으로 사용 설정하면 Unity가 프레임 속도의 변동을 줄이기 위해 프레임을 고르게 배포하여 게임플레이가 더 원활해집니다.

Unreal 게임 엔진에서 Swappy를 사용하는 방법

Unreal 4.25 이상에서는 Android Game Development Kit의 일부인 Android Frame Pacing 라이브러리를 통합합니다. 모바일 프레임 속도 도움말에서는 Android Frame Pacing 라이브러리를 사용 설정하는 방법과 C++ 코드에서 프레임 속도를 제어하는 방법을 설명합니다.

Vulkan이란 무엇인가요?

Vulkan은 기기 그래픽 하드웨어와 게임 간의 추상화를 최소화하도록 설계된 최신 크로스 플랫폼 3D 그래픽 API입니다. Vulkan은 Android의 기본 저수준 그래픽 API로, OpenGL ES를 대체합니다. OpenGL ES는 Android에서 계속 지원되지만 더 이상 기능이 개발되지 않습니다.

Vulkan은 OpenGL ES에 비해 다음과 같은 이점을 제공합니다.

  • 그래픽 드라이버의 CPU 오버헤드가 낮은 보다 효율적인 아키텍처
  • CPU 성능 개선을 위한 새로운 최적화 전략
  • OpenGL ES에서 사용할 수 없는 새로운 그래픽 기능(예: 바인딩 없는 API 및 레이 트레이싱)

네이티브 Android 프로젝트에서 Vulkan을 사용하는 방법

Android에서 Vulkan 시작하기 Codelab에서는 Vulkan 렌더링 파이프라인을 설정한 다음 화면에서 질감이 있는 회전하는 삼각형을 렌더링하는 방법을 안내합니다. Codelab을 사용하여 게임 그래픽을 렌더링하는 방법을 알아보세요.

Unity 게임 엔진에서 Vulkan을 사용하는 방법

Unity에서 자동 기기 선택을 사용 설정하려면 Auto Graphics API를 구성하는 단계를 따르세요.

프로젝트 설정 대화상자
그림 3. Unity Auto Graphics API를 사용 설정합니다.

또는 Auto Graphics API를 사용 중지하여 Vulkan을 수동으로 사용 설정하고 그래픽 API 목록에서 Vulkan을 가장 높은 우선순위로 설정할 수도 있습니다. Unity 2021.1 또는 이전 버전을 사용 중인 경우 이 방법이 Vulkan을 사용하는 유일한 방법입니다.

프로젝트 설정 대화상자
그림 4. Unity에서 기본 그래픽 API로 Vulkan을 수동으로 선택합니다.

VkQuality Unity 엔진 플러그인을 사용하여 게임이 특정 기기에서 사용할 그래픽 API의 실행 시간 권장사항을 제공합니다.

Unreal 게임 엔진에서 Vulkan을 사용하는 방법

Vulkan 그래픽 API를 사용 설정하려면 프로젝트 설정 > 플랫폼 > Android > 빌드로 이동하여 Vulkan 지원을 선택합니다. Vulkan 지원OpenGL ES3.2 지원을 모두 선택하면 Unreal에서 기본적으로 Vulkan을 사용합니다. 기기에서 Vulkan을 지원하지 않으면 Unreal이 OpenGL ES 3.2로 대체됩니다.

프로젝트 설정 대화상자
그림 5. Unreal Engine에서 Vulkan을 사용 설정합니다.

특정 기기에서 잘못 동작하는 것으로 알려진 특정 Vulkan 기능을 사용하는 경우 BaseDeviceProfile.ini 파일을 맞춤설정하여 이러한 기기를 제외할 수 있습니다. BaseDeviceProfile.ini를 맞춤설정하는 방법은 Android용 기기 프로필 및 확장성 맞춤설정을 참고하세요. 새 기기 드라이버는 이전에 알려진 잘못된 기기를 수정할 수 있으므로 모든 최적화를 위해 BaseDeviceProfile.ini 파일을 업데이트된 상태로 유지하세요.

ADPF란 무엇인가요?

Android 동적 성능 프레임워크 (ADPF)는 Android의 동적 열, CPU 및 GPU 관리 기능을 기반으로 게임을 최적화합니다. 이 앱은 게임에 초점을 맞추지만 성능 집약적인 다른 앱에도 이 기능을 사용할 수 있습니다.

ADPF는 API 집합으로, 게임 및 성능 집약적인 앱이 이 API를 사용하여 Android 기기의 전력 시스템 및 열 관련 시스템과 더 직접적으로 상호작용할 수 있습니다. 이러한 API를 사용하면 Android 시스템의 동적 동작을 모니터링하고 기기가 과열되지 않는 지속 가능한 수준에서 게임 성능을 최적화할 수 있습니다.

ADPF의 주요 기능은 다음과 같습니다.

  • Thermal API: 기기의 열 상태를 모니터링하여 지속 불가능해지기 전에 애플리케이션이 워크로드를 사전에 조정할 수 있도록 합니다.
  • CPU Performance Hint API: Android에서 워크로드에 적합한 성능 설정 (예: CPU 운영체제 또는 코어)을 선택할 수 있도록 하는 성능 힌트를 제공합니다.
  • Game Mode API 및 Game State API: 사용자 설정과 게임별 구성에 따라 성능이나 배터리 수명 특성에 우선순위를 지정하여 게임플레이를 최적화합니다.
  • 고정 성능 모드: 벤치마킹 중에 기기에서 고정 성능 모드를 사용 설정하여 동적 CPU 클록에 의해 변경되지 않는 측정값을 가져옵니다.
  • 전력 효율 모드: 성능보다 전력 효율을 우선시하도록 성능 힌트 세션의 스레드를 안전하게 예약할 수 있음을 세션에 알립니다. Android 15 (API 수준 35)에서 사용할 수 있습니다.

네이티브 Android 프로젝트에서 ADPF를 사용하는 방법

네이티브 게임에 적응성 기능 통합 Codelab에서는 원하는 속도로 ADPF 기능을 게임에 통합하는 방법을 안내합니다. Codelab이 끝나면 다음 기능이 통합됩니다.

  • Thermal API: 기기 열 상태를 수신 대기하고 기기가 열 제한 상태로 전환되기 전에 반응합니다.
  • Game Mode API: 플레이어 최적화 환경설정을 이해하고 (성능 극대화 또는 배터리 보존) 적절하게 조정합니다.
  • Game State API: 시스템에 게임의 상태 (로드 중, 재생, UI 등)를 알려주면 시스템이 그에 따라 리소스를 조정할 수 있습니다 (I/O 증가 또는 CPU, GPU 등).
  • Performance Hint API: 시스템이 적절하게 리소스를 할당할 수 있도록 스레딩 모델과 워크로드를 시스템에 알립니다.

Unity 게임 엔진에서 ADPF를 사용하는 방법

Unity의 적응형 성능은 휴대기기, 특히 다양한 Android 생태계에서 게임을 최적화하려는 게임 개발자를 위한 도구입니다. 적응형 성능을 사용하면 게임을 기기의 성능 및 열 특성에 실시간으로 맞게 조정하여 원활하고 효율적인 게임 환경을 보장할 수 있습니다.

적응형 성능 Android 제공자는 Unity에서 ADPF를 구현하는 단계를 안내합니다.

프로젝트 설정 대화상자
그림 6. Unity Engine에 ADPF를 통합합니다.

Unreal 게임 엔진에서 ADPF를 사용하는 방법

프로젝트 설정 대화상자
그림 7. Unreal Engine에 ADPF 통합
  1. 플러그인을 다운로드합니다.
  2. 플러그인을 프로젝트 플러그인 폴더에 복사합니다.
  3. Unreal 편집기에서 ADPF Unreal Engine 플러그인 사용 설정
  4. Unreal 편집기 다시 실행
  5. 게임 구축 및 요리

Unreal EngineAndroid Dynamic Performance Framework(ADPF) 플러그인은 안정적인 성능을 제공하고 열 제한을 방지합니다. GitHub에서 플러그인을 다운로드합니다. 이 플러그인은 Unreal 콘솔 값을 설정하여 기능을 변경합니다.