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)
    [email protected] 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安全距離內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!

推薦閱讀: