萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 獲取螢幕寬高工具類:DisplayMetrics 封裝與多窗口/刘海屏適配

自定義 View、彈窗定位、圖片縮放等場景頻繁需要螢幕尺寸。本文提供生產級 ScreenUtils 工具類,封裝 DisplayMetrics、WindowManager,支援多窗口模式、刘海屏安全區域、可用高度(扣除狀態欄/導航欄) 等進階需求。

一、基礎工具類 (Kotlin/Java 通用)

public class ScreenUtils {
    private ScreenUtils() {}

    /** 螢幕寬度 (px) */
    public static int getScreenWidth(Context context) {
        return getDisplayMetrics(context).widthPixels;
    }

    /** 螢幕高度 (px) */
    public static int getScreenHeight(Context context) {
        return getDisplayMetrics(context).heightPixels;
    }

    /** 密度 */
    public static float getDensity(Context context) {
        return getDisplayMetrics(context).density;
    }

    /** dp 轉 px */
    public static int dp2px(Context context, float dp) {
        return (int) (dp * getDensity(context) + 0.5f);
    }

    /** px 轉 dp */
    public static int px2dp(Context context, float px) {
        return (int) (px / getDensity(context) + 0.5f);
    }

    private static DisplayMetrics getDisplayMetrics(Context context) {
        WindowManager wm = (WindowManager) context.getSystemService(Context.WINDOW_SERVICE);
        DisplayMetrics metrics = new DisplayMetrics();
        wm.getDefaultDisplay().getRealMetrics(metrics); // 獲取真實物理尺寸(含刘海)
        return metrics;
    }
}

二、進階:可用高度 (扣除狀態欄/導航欄)

/** 獲取應用可用高度 (扣除狀態欄、導航欄、系統欄) */
public static int getUsableHeight(Context context) {
    WindowManager wm = (WindowManager) context.getSystemService(Context.WINDOW_SERVICE);
    DisplayMetrics metrics = new DisplayMetrics();
    wm.getDefaultDisplay().getMetrics(metrics); // 可用尺寸
    return metrics.heightPixels;
}

/** 獲取狀態欄高度 */
public static int getStatusBarHeight(Context context) {
    int resId = context.getResources().getIdentifier("status_bar_height", "dimen", "android");
    return resId > 0 ? context.getResources().getDimensionPixelSize(resId) : 0;
}

/** 獲取導航欄高度 */
public static int getNavigationBarHeight(Context context) {
    Resources res = context.getResources();
    int resId = res.getIdentifier("navigation_bar_height", "dimen", "android");
    return resId > 0 ? res.getDimensionPixelSize(resId) : 0;
}

三、多窗口/分屏模式下的尺寸獲取

// Activity 內直接獲取當前窗口尺寸
@Override
public void onConfigurationChanged(Configuration newConfig) {
    super.onConfigurationChanged(newConfig);
    int width = getResources().getConfiguration().screenWidthDp * getDensity(this);
    int height = getResources().getConfiguration().screenHeightDp * getDensity(this);
    // 此尺寸為當前窗口大小,非全螢幕物理尺寸
}

四、刘海屏/水滴屏安全區域 (API 28+)

// 在 View 中獲取安全區域插入邊距
ViewCompat.setOnApplyWindowInsetsListener(rootView, (v, insets) -> {
    Insets sysBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
    Insets ime = insets.getInsets(WindowInsetsCompat.Type.ime());
    // sysBars.top = 狀態欄高度(含刘海)
    // sysBars.bottom = 導航欄高度
    v.setPadding(sysBars.left, sysBars.top, sysBars.right, sysBars.bottom);
    return insets;
});

五、使用示例

// 自定義 View 中
int screenW = ScreenUtils.getScreenWidth(context);
int itemW = (screenW - ScreenUtils.dp2px(context, 32)) / 3; // 3列,邊距16dp*2

// Dialog 全屏寬度
dialog.getWindow().setLayout(ScreenUtils.getScreenWidth(context), WindowManager.LayoutParams.WRAP_CONTENT);

將工具類納入基礎庫模組,統一全專案螢幕尺寸獲取口徑,避免重複造輪子與邏輯不一致。

copyright © 萬盛學電腦網 all rights reserved