Mir 2: Return of the King is a high-quality Legend IP mobile game authorized by Actoz Soft and developed by HK ZHILI YAOAN LIMITED using the Unity game engine.
This game not only perfectly recreates the feelings of Mir 2, a representative of Korean fantasy MMORPG, but also offers many of the most popular game contents, such as equipment collection, large-scale sand attack, and other core gameplay.
The game used the Android Frame Pacing library (Swappy) to improve the stability of its frame rate, achieve smooth rendering, and significantly boost their Android Vitals (Slow Session metric).
Slow Sessions launched on Android vitals
Slow Sessions is an Android vitals metric in Google Play console. A slow session has more than 25% slow frames. A frame is slow if it is:
At 20fps, it is not presented within 50ms after the previous frame.
At 30fps, it is not presented within 34ms after the previous frame.
In due course, Play will start steering users away from games that cannot achieve 20 FPS on their phones.
There are many reasons a frame might present or render longer on the screen than the developer's target frame time. The game could be CPU or GPU bound, overheating (causing thermal throttling), or there's a mismatch in the game's framerate and the device's display refresh rate.
What is the Frame Pacing library
The Android Frame Pacing library, also known as Swappy, is part of the AGDK libraries. Swappy helps OpenGL and Vulkan games achieve smooth rendering and correct frame pacing on Android.
The library handles multiple refresh rates if they are supported by the device, which gives a game more flexibility in presenting a frame. For example, for a device that supports a 60 Hz refresh rate as well as 90 Hz, a game that cannot produce 60 frames per second can drop to 45 FPS instead of 30 FPS to remain smooth. The library detects the expected game frame rate and auto-adjusts frame presentation times accordingly.
The Frame Pacing library also improves battery life because it avoids unnecessary display updates. For example, if a game is rendering at 60 FPS but the display is updating at 120 Hz, the screen is updated twice for every frame. The Frame Pacing library avoids this by setting the refresh rate to the value supported by the device that's closest to the target frame rate.
How Mir 2 improved Rendering performance with the Frame Pacing library
Mir 2 (미르2: 왕의 귀환) was facing an issue with unstable rendering performance where they experienced 40% slow sessions at a framerate threshold of 20 FPS, much higher than Google Play's 20% threshold.
Mir 2 (미르2: 왕의 귀환) is a high fidelity graphic game, some devices are facing challenges to maintain a stable FPS. Their frame rate distribution shows lots of sessions are running at FPS lower than 20fps.
Each bucket represents the percentage of sessions where 75% of their frames were faster than the bucket label.
When the display workload takes longer than the application workload, additional frames are added to a queue. This leads, once again, to stuttering and may also lead to an extra frame of latency due to buffer-stuffing.
The Frame Pacing library solves this by using sync fences
(EGL_KHR_fence_sync and VkFence) to
inject waits into the application that allow the display pipeline to catch up,
rather than allowing back pressure to build up. Frame A still presents an extra
frame, but frame B now presents correctly.
Mir 2 easily integrated the Frame Pacing library by leveraging Unity's built in Optimized Frame Pacing feature. The action resulted in significant improvement for their rendering performance, specifically dropping the Slow Session metric from 40% to 10%.
The number of slow sessions have been reduced significantly for Mir2 after they integrated the library.
Each bucket represents the percentage of sessions where 75% of their frames were faster than the bucket label.
Get Started with the Frame Pacing library
How to use the Frame Pacing library in native game engines
See the following guides to integrate the Android Frame Pacing library into your game:
- Integrate Android Frame Pacing into your Vulkan renderer
- Integrate Android Frame Pacing into your OpenGL renderer
How to use the Frame Pacing library in the Unity game engine
Unity has integrated the Android Frame Pacing library into their engine. To enable this feature in Unity, check the Optimized Frame Pacing checkbox under Project Settings > Player > Settings for Android > Resolution and Presentation:
Alternatively, programmatically enable the Optimized Frame Pacing option in your logic code to allow Unity to evenly distribute frames for less variance in frame rate, creating smoother gameplay.
How to use the Frame Pacing library in Unreal game engine
Unreal 4.25 and later integrates the Android Frame Pacing library, which is part of the Android Game Development Kit. The Mobile Frame Pacing article explains how to enable the Android Frame Pacing library and how to control frame pacing from C++ code.