API處理Android安全距離詳情
前言
在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)文章希望大家以后多多支持腳本之家!

Android自定義View實現(xiàn)loading動畫加載效果

android中使用Activity實現(xiàn)監(jiān)聽手指上下左右滑動