獲取螢幕寬高、密度 (dpi) 是適配佈局、計算像素轉換的基礎。現代 Android 建議使用 WindowMetrics (API 30+) 或 DisplayMetrics 相容舊版。本文整理標準做法與常見誤區。
val windowMetrics = windowManager.currentWindowMetrics
val bounds = windowMetrics.bounds
val widthPx = bounds.width()
val heightPx = bounds.height()
val density = resources.displayMetrics.density // 還是用 DisplayMetrics 取密度
val displayMetrics = DisplayMetrics()
windowManager.defaultDisplay.getMetrics(displayMetrics)
val widthPx = displayMetrics.widthPixels
val heightPx = displayMetrics.heightPixels
val density = displayMetrics.density // 邏輯密度 (1.0 = mdpi)
val densityDpi = displayMetrics.densityDpi // 實際 DPI (160, 240, 320, 480...)
val scaledDensity = displayMetrics.scaledDensity // 字體縮放因子
// dp → px
fun dpToPx(dp: Float): Int = (dp * Resources.getSystem().displayMetrics.density + 0.5f).toInt()
// px → dp
fun pxToDp(px: Int): Float = px / Resources.getSystem().displayMetrics.density
// sp → px (字體)
fun spToPx(sp: Float): Int = (sp * Resources.getSystem().displayMetrics.scaledDensity + 0.5f).toInt()
getMetrics 回傳整個螢幕尺寸,多視窗下應用只佔部分區域。請改用 WindowMetrics 或 View.getWidth() 取得實際繪製區域。WindowInsets (API 20+) 或 WindowInsetsController (API 30+),勿硬編碼高度。density = densityDpi / 160f;density 用於 dp↔px 換算,densityDpi 用於判斷裝置密度桶 (ldpi/mdpi/hdpi/xhdpi/xxhdpi/xxxhdpi)。ConstraintLayout + dp / sp,避免手動計算像素。Resources.getSystem().displayMetrics 避免 Context 洩漏。
3. 測試時開啟「開發者選項 → 繪圖 → 螢幕尺寸/密度」驗證適配。
掌握標準 API 與單位換算,即可從容應對各種螢幕規格與多視窗模式。