API處理Android安全距離詳情

前言

在Android螢幕的空間中，大部分的區域我們都是可以隨意繪製，只有一部分割區域是顯示的固定內容：

• 狀態列
• 標題列(ActionBar)
• 頁面內容(Content)
• 導航欄

其中標題列是可選的，除了Material風格的應用應用的並不多，頁面內容就是android.R.id.content是Activity的主要內容。

而我們主要需要討論的就是 狀態列和導航欄，因為這兩個區域在不同裝置型別，不同的Android版本和不同的廠商下大小和效果是不同的，等等。這些差異無疑增加了我們做頁面適配的複雜程度，也更容易出現相容問題。

在2017年下半年iPhone X的釋出，引入了劉海屏裝置，導致了藍綠大廠爭相效仿，同時又自成一派，頗有一番百家爭鳴之象。 這也導致了一個新的問題 劉海區域適配 ，那時候Android才8.1，並沒有API來支援這螢幕上這多出來的一塊區域，不過好在大部分裝置在客製化時劉海和狀態列高度是一致的。

終於在2018年釋出的Android 9中Google正式支援了劉海屏，客製化了規範約束了裝置廠商，減輕了劉海屏適配的差異問題，但是根源問題並沒有解決。因為劉海區域的存在，可能會出現頁面內容被遮擋，比如：啟用頁廣告跳過按鈕被遮擋的問題，導致被應用商店拒掉的風險。

不過好在Android 9中要求劉海裝置必須有以下行為：

• 一條邊緣最多隻能包含一個劉海。
• 一臺裝置不能有兩個以上的劉海。
• 裝置的兩條較長邊緣上不能有劉海。
• 在未設定特殊標誌的豎屏模式下，狀態列的高度必須與劉海的高度持平。
• 預設情況下，在全螢幕模式或橫屏模式下，整個劉海區域必須顯示黑邊。

劉海高度預設是和狀態列高度一致依舊沒有變，所以問題又回到了狀態列區域的處理。

描述

所以肯定有同學說了：直接獲取狀態列高度不就可以了適配劉海屏了。像這樣：

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

這麼說也沒有錯，大部分情況下是沒有問題的。但是既然官方已經適配劉海屏了，也為我們提供了新的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)
    }
}

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

新增依賴：

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 // 高版本已經過時，可以用下面的api替換
    val stableInsets = insets.getInsets(
    WindowInsetsCompat.Type.systemBars() or WindowInsetsCompat.Type.displayCutout())
    titleBar.setPadding(0, stableInsets.top, 0, 0)
    return@setOnApplyWindowInsetsListener insets
}

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

系統欄適配

上面提到了手機有各種系統欄（狀態列、導航欄），如果一個全螢幕+劉海屏+透明系統欄+螢幕旋轉的頁面處理這些安全距離就更復雜，比如短視訊頁，這裡先給大家列幾條可能出現的問題：

• 沒有導航欄或者可以動態隱藏導航欄的裝置
• 導航欄不會旋轉的裝置（就是導航欄一直在螢幕的一個邊，不會跟隨螢幕旋轉）
• 導航欄跟隨螢幕旋轉的裝置（主要是手勢導航的裝置和一些平板上）
• 劉海在螢幕底部的裝置（開發者選項可以開啟雙劉海模式，裝置兩個短邊都有劉海）
• 底部劉海+導航欄一起顯示的裝置
• ... ...

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

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

然後在對不同位置的控制元件新增對應的邊距。除了上面提到的三種型別的安全距離，還有一些其他的型別，有興趣的可以自己瞭解。

其他適配

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真機發現能獲取到資料，但是模擬器獲取不到。

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

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

隱私指示器的範圍，主要是 攝像頭和麥克風 使用中狀態的指示器邊界，如果是錄製直播或者相機的頁面需要處理這個區域。

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

到此這篇關於API處理Android安全距離詳情的文章就介紹到這了,更多相關 Android安全距離內容請搜尋it145.com以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援it145.com！