Screen.SetResolution

Description

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.