Variable Refresh Rate API
The Variable Refresh Rate API allows you to change the current display refresh rate. The API provides
IVariableRefreshRate.SupportedRefreshRates, an array of display refresh rates that the device supports. To change the current refresh rate, call
IVariableRefreshRate.SetRefreshRateByIndex with a valid index for the array of supported refresh rates.
Note: The supported refresh rates depend on the model of the phone, Android Display Settings, and application-specific settings in Samsung Game Launcher.
The Variable Refresh Rate API is supported on all devices where
UnityEngine.AdaptivePerformance.Samsung.Android.VariableRefreshRate.Instance is not
If the current refresh rate or the list of supported refresh rate changes because of an external event, the
IVariableRefreshRate.RefreshRateChanged event is triggered. This can happen when a user is making changes to the Display Settings.
The Unity core API
Screent.currentResolution.refreshRate is automatically updated when the refresh rate changes. This update might not happen immediately, so it is not recommended to cache the value of
Screent.currentResolution.refreshRate in your application.
This version of VRR is compatible with Unity Editor versions 2019 LTS and later, specifically:
- Unity 2020.2.0a7+
- Unity 2020.1.0b5+
- Unity 2019.3.11f1+
Variable Refresh Rate is currently only supported on following devices:
- Galaxy S20 with GameSDK 3.2 (April 2020 update).