前言

在Android屏幕的空間中，大部分的區(qū)域我們都是可以隨意繪制，只有一部分區(qū)域是顯示的固定內(nèi)容：

• 狀態(tài)欄
• 標(biāo)題欄(ActionBar)
• 頁面內(nèi)容(Content)
• 導(dǎo)航欄

其中標(biāo)題欄是可選的，除了Material風(fēng)格的應(yīng)用應(yīng)用的并不多，頁面內(nèi)容就是android.R.id.content是Activity的主要內(nèi)容。

而我們主要需要討論的就是 狀態(tài)欄和導(dǎo)航欄，因為這兩個區(qū)域在不同設(shè)備類型，不同的Android版本和不同的廠商下大小和效果是不同的，等等。這些差異無疑增加了我們做頁面適配的復(fù)雜程度，也更容易出現(xiàn)兼容問題。

在2017年下半年iPhone X的發(fā)布，引入了劉海屏設(shè)備，導(dǎo)致了藍(lán)綠大廠爭相效仿，同時又自成一派，頗有一番百家爭鳴之象。 這也導(dǎo)致了一個新的問題 劉海區(qū)域適配 ，那時候Android才8.1，并沒有API來支持這屏幕上這多出來的一塊區(qū)域，不過好在大部分設(shè)備在定制時劉海和狀態(tài)欄高度是一致的。

終于在2018年發(fā)布的Android 9中Google正式支持了劉海屏，定制了規(guī)范約束了設(shè)備廠商，減輕了劉海屏適配的差異問題，但是根源問題并沒有解決。因為劉海區(qū)域的存在，可能會出現(xiàn)頁面內(nèi)容被遮擋，比如：啟用頁廣告跳過按鈕被遮擋的問題，導(dǎo)致被應(yīng)用商店拒掉的風(fēng)險。

不過好在Android 9中要求劉海設(shè)備必須有以下行為：

• 一條邊緣最多只能包含一個劉海。
• 一臺設(shè)備不能有兩個以上的劉海。
• 設(shè)備的兩條較長邊緣上不能有劉海。
• 在未設(shè)置特殊標(biāo)志的豎屏模式下，狀態(tài)欄的高度必須與劉海的高度持平。
• 默認(rèn)情況下，在全屏模式或橫屏模式下，整個劉海區(qū)域必須顯示黑邊。

劉海高度默認(rèn)是和狀態(tài)欄高度一致依舊沒有變，所以問題又回到了狀態(tài)欄區(qū)域的處理。

描述

所以肯定有同學(xué)說了：直接獲取狀態(tài)欄高度不就可以了適配劉海屏了。像這樣：

val top = context.getStatusBarHeight()
titleBar.setPadding(0, top, 0, 0)

這么說也沒有錯，大部分情況下是沒有問題的。但是既然官方已經(jīng)適配劉海屏了，也為我們提供了新的API為什么不用呢：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
    window.decorView.post {
        val top = window.decorView.rootWindowInsets?.displayCutout?.safeInsetTop ?: 0
        // val bottom = window.decorView.rootWindowInsets?.displayCutout?.safeInsetBottom ?: 0
        titleBar.setPadding(0, top, 0, 0)
    }
}

上面的方案實際上可以獲取上下左右四個方向的安全距離，但大部分情況我們只需要處理頂部就可以了。實際上這已經(jīng)可以解決我們的問題了，但是還有更好的解決方案方案：

添加依賴：

implementation 'androidx.core:core:1.7.0'

// 老版本也可以，但是getInsets() API 還沒添加
// implementation 'androidx.core:core:1.3.0'

使用ViewCompat工具：

ViewCompat.setOnApplyWindowInsetsListener(titleBar) { view: View, insets: WindowInsetsCompat ->
    //val top = insets.systemWindowInsetTop // 高版本已經(jīng)過時，可以用下面的api替換
    val stableInsets = insets.getInsets(
    WindowInsetsCompat.Type.systemBars() or WindowInsetsCompat.Type.displayCutout())
    titleBar.setPadding(0, stableInsets.top, 0, 0)
    return@setOnApplyWindowInsetsListener insets
}

實際上屏幕安全距離，基本上全部圍繞這一個API，Google也推薦我們這么做，在很多系統(tǒng)控件都能看到它的影子，比如：AppBarLayout、DrawerLayout、NavigationBarView等等都有用到，內(nèi)部都是來處理系統(tǒng)安全距離的。

系統(tǒng)欄適配

上面提到了手機有各種系統(tǒng)欄（狀態(tài)欄、導(dǎo)航欄），如果一個全屏+劉海屏+透明系統(tǒng)欄+屏幕旋轉(zhuǎn)的頁面處理這些安全距離就更復(fù)雜，比如短視頻頁，這里先給大家列幾條可能出現(xiàn)的問題：

• 沒有導(dǎo)航欄或者可以動態(tài)隱藏導(dǎo)航欄的設(shè)備
• 導(dǎo)航欄不會旋轉(zhuǎn)的設(shè)備（就是導(dǎo)航欄一直在屏幕的一個邊，不會跟隨屏幕旋轉(zhuǎn)）
• 導(dǎo)航欄跟隨屏幕旋轉(zhuǎn)的設(shè)備（主要是手勢導(dǎo)航的設(shè)備和一些平板上）
• 劉海在屏幕底部的設(shè)備（開發(fā)者選項可以開啟雙劉海模式，設(shè)備兩個短邊都有劉海）
• 底部劉海+導(dǎo)航欄一起顯示的設(shè)備
• ... ...

這些所有的問題通過 ViewCompat.setOnApplyWindowInsetsListener() 來優(yōu)雅處理， 通過 WindowInsetsCompat.getInsets(type) 可以獲取系統(tǒng)的各個欄的大小， 我們也可以同時獲取多個系統(tǒng)欄的高度，各個距離內(nèi)部會進(jìn)行累加，返回一個類似Rect的對象，對應(yīng)屏幕的左上右下需要插入的距離：

val stableInsets = insets.getInsets(
    WindowInsetsCompat.Type.statusBars() or
    WindowInsetsCompat.Type.navigationBars() or
    WindowInsetsCompat.Type.displayCutout())

然后在對不同位置的控件添加對應(yīng)的邊距。除了上面提到的三種類型的安全距離，還有一些其他的類型，有興趣的可以自己了解。

其他適配

ViewCompat.setOnApplyWindowInsetsListener()能解決大部分安全距離的問題，但是有一點它是處理不了的，就是 屏幕圓角，這些安全距離的計算是不處理屏幕圓角的，所以如果有圓角要處理那我們就要另辟蹊徑了。

好在Android 12中官方添加了對圓角的支持：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    val roundedCorner = insets.toWindowInsets()
        ?.getRoundedCorner(RoundedCorner.POSITION_TOP_LEFT)
    roundedCorner?.center
}

我用了Pixel4真機發(fā)現(xiàn)能獲取到數(shù)據(jù)，但是模擬器獲取不到。

除了圓角支持，還有對隱私指示器提供了支持：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    val rect = insets.toWindowInsets()?.privacyIndicatorBounds
    // 頁面控件需要避開這個區(qū)域，不然可能會被遮擋
}

隱私指示器的范圍，主要是 攝像頭和麥克風(fēng) 使用中狀態(tài)的指示器邊界，如果是錄制直播或者相機的頁面需要處理這個區(qū)域。

除了圓角以外，好像沒有找到官方對打孔屏的支持，可能后面會加入對打孔屏的支持吧。

到此這篇關(guān)于API處理Android安全距離詳情的文章就介紹到這了,更多相關(guān) Android安全距離內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！