如何在Android中获取当前屏幕分辨率？

Question

在Android开发中，如何准确获取当前屏幕分辨率是一个常见问题。许多开发者使用`DisplayMetrics`结合`WindowManager`获取屏幕宽高，但在部分机型或全面屏设备上，因状态栏、导航栏或折叠屏适配问题，导致获取的分辨率与实际可用区域不符。此外，`getRealMetrics()`与`getCurrentSizeRange()`等方法的适用场景容易混淆，造成兼容性问题。如何在不同Android版本（尤其是API 30以上）和多样化屏幕环境下，正确获取真实的物理屏幕分辨率？

Answer 1

Android开发中准确获取屏幕分辨率的深度解析

1. 问题背景与常见误区

在Android开发中，获取屏幕分辨率是UI适配、布局计算和性能优化的基础操作。许多开发者习惯使用DisplayMetrics结合WindowManager来获取宽高：

DisplayMetrics metrics = new DisplayMetrics();
getWindowManager().getDefaultDisplay().getMetrics(metrics);
int width = metrics.widthPixels;
int height = metrics.heightPixels;

然而，这种方法获取的是应用可用区域的尺寸，而非真实的物理分辨率。在全面屏、刘海屏、折叠屏设备上，由于系统UI（如状态栏、导航栏）占用空间，实际返回值会小于真实屏幕像素。

2. 核心API对比分析

为解决上述问题，Android提供了多个用于获取屏幕信息的API。以下是关键方法的对比：

方法	适用API级别	是否包含系统UI	返回值说明
getMetrics()	API 1+	否（扣除状态栏/导航栏）	应用可视区域大小
getRealMetrics()	API 17+	是	真实物理分辨率
getCurrentSizeRange()	API 13+	否	最小和最大可用尺寸范围
getRealSize()	API 17+	是	物理宽高（Point对象）

3. 针对不同Android版本的兼容性策略

从API 30（Android 11）开始，部分旧API被标记为废弃，推荐使用Display.getRealMetrics()或通过Context#getDisplay()获取当前显示实例。

• API < 17：使用getRealSize(Point)需反射调用
• API ≥ 17：直接调用display.getRealMetrics(DisplayMetrics)
• API ≥ 30：建议结合WindowManager.getCurrentWindowMetrics()进行动态适配

4. 正确获取物理分辨率的实现方案

以下是一个跨版本兼容的真实分辨率获取工具类片段：

public static Point getPhysicalResolution(Context context) {
    WindowManager wm = (WindowManager) context.getSystemService(Context.WINDOW_SERVICE);
    Display display = wm.getDefaultDisplay();
    DisplayMetrics metrics = new DisplayMetrics();
    
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR1) {
        display.getRealMetrics(metrics);
    } else {
        try {
            Method method = display.getClass().getMethod("getRawWidth");
            int width = (Integer) method.invoke(display);
            int height = (Integer) method.invoke(display, "getRawHeight");
            return new Point(width, height);
        } catch (Exception e) {
            display.getMetrics(metrics);
        }
    }
    return new Point(metrics.widthPixels, metrics.heightPixels);
}

5. 折叠屏与多窗口模式下的挑战

在可折叠设备或分屏模式下，getRealMetrics()可能返回主屏幕的总分辨率，而非当前窗口所在显示屏的实际尺寸。此时应结合Configuration.densityDpi与Activity#isInMultiWindowMode()判断运行环境。

Android 11引入了WindowMetrics API，可通过以下方式获取当前窗口的实际边界：

If (Build.VERSION.SDK_INT >= 30) {
    WindowMetrics metrics = getWindowManager().getCurrentWindowMetrics();
    Rect bounds = metrics.getBounds();
    int width = bounds.width();
    int height = bounds.height();
}

6. 实际应用场景与决策流程图

根据目标需求选择合适的API至关重要。以下是决策逻辑的可视化表示：

graph TD
            A[需要获取屏幕分辨率] --> B{是否需要包含系统UI?}
            B -->|是| C[使用getRealMetrics()]
            B -->|否| D[使用getCurrentWindowMetrics()或getMetrics()]
            C --> E{API Level >= 17?}
            E -->|是| F[直接调用]
            E -->|否| G[通过反射获取Raw尺寸]
            D --> H[考虑多窗口/折叠屏适配]
            H --> I[优先使用Android 11+ WindowMetrics API]

7. 测试验证与常见坑点

在真实设备测试时应注意：

1. 华为、小米等厂商对导航栏隐藏逻辑有自定义处理，可能导致getRealMetrics()仍返回非全屏值
2. 某些Oppo机型在游戏模式下禁用底部虚拟键，但API未同步更新
3. 模拟器与真机表现不一致，尤其在Android 10以上版本
4. 横竖屏切换后需重新获取，避免缓存旧值
5. 动态刷新率设备（如120Hz）不影响分辨率获取，但影响布局渲染节奏
6. 第三方Launcher可能修改默认显示行为
7. Android TV设备通常无状态栏，但存在边框缩放设置
8. Chromebook运行Android应用时，屏幕区域受桌面环境限制
9. 隐私模式或安全键盘弹出时临时改变可用高度
10. 部分低端设备ROM篡改Display服务导致数据失真