首頁 > 軟體

Android 無障礙全域性懸浮窗實現範例

2022-06-14 18:00:47

Android 無障礙的全域性懸浮窗可以在螢幕上新增 UI 供使用者進行快捷操作,可以展示在所有應用程式之上長期展示。另一方面,在一些自動化場景下,可以用來遮蔽使用者行為,防止使用者手動操作打斷自動化流程。

無障礙新增 UI

無障礙服務新增 UI 十分簡單,使用 LayoutInflater 在 AccessibilityService 的 onServiceConnected 新增一個 UI:

    // in AccessibilityService, service 代表 AccessibilityService 的子類範例
    private fun initView() {
        // 在螢幕頂部新增一個 View
        val wm = service.getSystemService(AccessibilityService.WINDOW_SERVICE) as? WindowManager
        val lp = WindowManager.LayoutParams().apply {
            type = TYPE_ACCESSIBILITY_OVERLAY // 因為此許可權才能展示處理
          	layoutInDisplayCutoutMode = LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
            format = PixelFormat.TRANSLUCENT
            flags = flags or
                    FLAG_LAYOUT_NO_LIMITS or
                    FLAG_NOT_TOUCHABLE or  // 透傳觸控事件
                    FLAG_NOT_FOCUSABLE or  // 透傳輸入事件
                    FLAG_LAYOUT_IN_SCREEN
            width = MATCH_PARENT
            height = MATCH_PARENT
        }
        // 通過 LayoutInflater 建立 View 
        val rootView = LayoutInflater.from(service).inflate(R.layout.float_layer, null)
        wm?.addView(rootView, lp)
    }

然後在自定義的無障礙服務中去呼叫這個方法:

class MyAccessibilityService: AccessibilityService() {
    override fun onServiceConnected() {
        super.onServiceConnected()
        initView()
    }
    // ...
}

需要注意的是,這裡不能將 initView 新增到 onCreate 生命週期中,官方檔案也有一些放在 onCreate 中的操作,但實際上都會導致 crash 。

java.lang.RuntimeException: Unable to create service com.chunyu.accessibilitydemo.service.AccessibilityDemoService: android.view.WindowManager$BadTokenException: Unable to add window -- token null is not valid; is your activity running?

無障礙服務所有的初始化工作,都要放在 onServiceConnected 中執行。這樣就可以將自定義的 UI 展示到螢幕上了。

關於無障礙服務的設定,可以參考官方 API 。

設定分析

從使用上來看,無障礙蒙層是通過 WindowManager 新增到螢幕上的。而關鍵的一些資訊在 WindowManager.LayoutParams 設定的資料中。

Type

Window 有一個關鍵的屬性 type ,它被定義在 WindowManager 的內部類 LayoutParams 中,它可以控制 Window 的顯示次序。主要分為三種:

  • Application Window:應用程式視窗 1-99 ,應用程式視窗一般位於最底層。
  • System Window:系統視窗 2000-2999 ,系統級視窗一般位於最頂層,不會被其他的window遮住。
  • Sub Window:子視窗 1000-1999,子視窗一般是顯示在應用視窗之上。

從三種視窗的值也可推斷出,type 的值越大,Window 就越靠近使用者。

在上面的使用中,我們將 type 設定為 TYPE_ACCESSIBILITY_OVERLAY ,它的值是 2032 ,是一個系統視窗,所以可以展示在應用程式之上。 TYPE_ACCESSIBILITY_OVERLAY ,是無障礙服務用來展示 UI 專用的 視窗型別 。使用它可以在所有的應用程式上展示蒙層。

Flag

flag 中包含了兩個關鍵的值 FLAG_NOT_TOUCHABLEFLAG_NOT_FOCUSABLE ,和一些其他的 flag 。設定這兩個內容,蒙層將不會影響任何使用者操作。

  • FLAG_NOT_TOUCHABLE :可以將 Window 設定為永不接收觸控事件,從而能夠將觸控事件透傳給蒙層遮蓋住的區域,不阻塞使用者操作。

  • FLAG_NOT_FOCUSABLE :可以將 Window 設定為永不獲取按鍵輸入焦點,使用者無法向這個 Window 傳送按鍵或其他的按鈕時間,而被它覆蓋的內容可以接收並響應事件。

  • FLAG_LAYOUT_NO_LIMITS :允許視窗延伸到螢幕之外。

  • FLAG_LAYOUT_IN_SCREEN :將視窗放置在整個螢幕中,忽略來自父視窗的任何約束。

LayoutInDisplayCutoutMode

這個屬性可以用來控制 Window 在劉海屏的佈局方式。

  • LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT :僅當劉海屏完全包含在系統欄中時,才允許視窗擴充套件到劉海區域。 否則,視窗的佈局使其不與劉海區域重疊。
  • LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES :允許 Window 延伸到短的一側邊緣的劉海區域。
  • LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER :Window 不允許延伸到劉海屏區域。
  • LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS :允許 Window 延伸到所有的螢幕邊緣劉海區域。

到此這篇關於Android 無障礙全域性懸浮窗實現範例的文章就介紹到這了,更多相關Android 無障礙全域性懸浮窗內容請搜尋it145.com以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援it145.com!


IT145.com E-mail:sddin#qq.com