Switches the screen resolution.
A width
by height
resolution will be used.
If no matching resolution is supported, the closest one will be used.
If preferredRefreshRate
is 0 (default) Unity will switch to the highest refresh rate supported by the monitor.
If preferredRefreshRate
is not 0 Unity will use it if the monitor supports it, otherwise will choose
the highest supported one.
On Android fullscreen
controls the SYSTEM_UI_FLAG_LOW_PROFILE flag to View.setSystemUiVisibility(), on
devices running Honeycomb (OS 3.0 / API 11) or later.
On Windows Store Apps, switching to non-native resolution is only supported starting from Windows 8.1 and newer.
To set a specific full-screen mode on a desktop platform, use the method overload tht accepts the FullScreenMode parameter.
A resolution switch does not happen immediately; it will actually happen when the current frame is finished.
using UnityEngine;
public class ExampleScript : MonoBehaviour { void Start() { // Switch to 640 x 480 full-screen Screen.SetResolution(640, 480, true); } }
Another example:
using UnityEngine;
public class ExampleScript : MonoBehaviour { void Start() { // Switch to 640 x 480 full-screen at 60 hz Screen.SetResolution(640, 480, true, 60); } }
Another example:
using UnityEngine;
public class ExampleScript : MonoBehaviour { void Start() { // Switch to 800 x 600 windowed Screen.SetResolution(800, 600, false); } }
See Also: resolutions property.