【Unity】屏幕相关Screen知识点

前言

在游戏开发中，处理屏幕分辨率、设备方向和全屏状态等相关问题是至关重要的。这些因素会直接影响到游戏的玩家体验，包括游戏的视觉效果和交互感受。例如，我们可能需要在不同的屏幕分辨率下优化游戏的用户界面，或者我们可能想要在设备旋转时改变游戏的方向。在Unity游戏开发环境中，Screen类就是一个提供了这些功能的工具。

一、屏幕尺寸与分辨率相关

1、Screen.width

返回屏幕的宽度，单位为像素。

可能的输出:屏幕宽度: 1920

Debug.Log("屏幕宽度: " + Screen.width);

2、Screen.height

返回屏幕的高度，单位为像素。

可能的输出: 屏幕高度: 1080

Debug.Log("屏幕高度: " + Screen.height);

3、Screen.dpi

返回当前屏幕的dpi（每英寸点数）。对于不支持读取dpi的设备，将返回0.0。

可能的输出: 屏幕DPI: 96

Debug.Log("屏幕DPI: " + Screen.dpi);

4、Screen.currentResolution

返回屏幕当前的分辨率。

可能的输出: 当前分辨率: 1920 x 1080 @ 60Hz

Debug.Log("当前分辨率: " + Screen.currentResolution.ToString());

5、Screen.resolutions

返回所有支持的屏幕分辨率。

可能的输出: 支持的屏幕分辨率: 800 x 600 @ 60Hz

foreach (Resolution res in Screen.resolutions)
{
    Debug.Log("支持的屏幕分辨率: " + res.ToString()); 
}

6、Screen.SetResolution()

设置屏幕的分辨率。这个方法需要三个参数：宽度，高度和是否全屏。

例如：设置屏幕分辨率为1024x768，并设置为全屏模式

Screen.SetResolution(1024, 768, true);

二、屏幕方向相关

1、Screen.orientation

用于获取或设置屏幕的方向。

可能的输出: 当前方向: LandscapeLeft

ScreenOrientation currentOrientation = Screen.orientation;
Debug.Log("当前方向: " + currentOrientation.ToString()); 

2、Screen.autorotateToPortrait

当此属性设置为true时，设备将被允许自动旋转到纵向模式。

Screen.autorotateToPortrait = true;

3、Screen.autorotateToPortraitUpsideDown

当此属性设置为true时，设备将被允许自动旋转到纵向倒置模式。

Screen.autorotateToPortraitUpsideDown = true;

4、Screen.autorotateToLandscapeLeft和Screen.autorotateToLandscapeLeft

当此属性设置为true时，设备将被允许自动旋转到横向左侧/右侧模式。

Screen.autorotateToLandscapeLeft = true;
Screen.autorotateToLandscapeRight = true;

三、全屏模式相关

1、Screen.fullScreen

这个属性可以用来获取或设置游戏是否处于全屏模式。

可能的输出: 是否全屏: true

bool isFullScreen = Screen.fullScreen;
Debug.Log("是否全屏: " + isFullScreen);
Screen.fullScreen = false;

2、Screen.fullScreenMode

这个属性可以用来获取或设置全屏模式的类型。它是一个枚举，包括 ExclusiveFullScreen, FullScreenWindow, MaximizedWindow, Windowed

可能的输出: 当前全屏模式为: ExclusiveFullScreen

FullScreenMode currentFullScreenMode = Screen.fullScreenMode;
Debug.Log("当前全屏模式为: " + currentFullScreenMode.ToString());
Screen.fullScreenMode = FullScreenMode.Windowed;//设置全屏模式为窗口模式

四、其他

1、Screen.sleepTimeout

控制屏幕的休眠超时时间。比如你可以设置为 NeverSleep，那么屏幕将永不进入休眠。

Screen.sleepTimeout = SleepTimeout.NeverSleep;

2、Screen.brightness

这个属性用于获取或设置屏幕的亮度。它的值范围为0.0到1.0，其中0.0代表最暗，1.0代表最亮。此功能主要在移动设备上有效；在Windows平台，获取此属性将返回1.0，设置此属性将无效。

如果你想将屏幕亮度设置为最亮，可以使用以下代码：

Screen.brightness = 1.0f;

3、Screen.safeArea

返回屏幕的安全区域(可显示区域)。这个区域是所有可能的硬件和软件遮挡都被排除的屏幕区域，比如刘海屏或圆角等。

可能的输出: 安全区域: (0.0, 0.0, 1080.0, 1920.0)

Rect safeArea = Screen.safeArea;
Debug.Log("安全区域: " + safeArea.ToString());

4、Screen.cutouts

返回不能显示内容的屏幕区域列表。cutouts是指设备屏幕上的一块区域，由于硬件（如摄像头，扬声器等）的存在，这块区域无法显示内容。特别是对于处理刘海屏或其他带有硬件级别遮挡的设备。

以下是一个简单的例子，获取并打印设备屏幕的所有cutouts的尺寸和位置：

 Rect[] cutouts = Screen.cutouts;
 foreach(Rect cutout in Screen.cutouts)
 {
     Debug.Log("Cutout位置: " + cutout.position);
     Debug.Log("Cutout尺寸: " + cutout.size);
 }

在设计游戏的用户界面时，需要考虑到cutouts的存在，避免将重要的信息或者控件放在cutouts覆盖的区域，从而影响用户的体验。