1、前言

Android的輔助功能是個比較老的API（since API 4），但是該API真正的開始發展還是在API 16~19（很多常用的方法引數都是在這幾個版本逐漸加入以及完善的）版本中。輔助功能我們最常見的是在類似深度休眠，搶紅包中使用，模擬點選螢幕view。此次寫關於輔助功能的分享是因為在API 24、 API 26中，又增添了幾個類以及幾個介面。

本文首先介紹關於輔助功能的常見使用方法，然後開始介紹輔助功能新增介面以及類的使用。

2、輔助功能的使用

2.1 輔助功能常規使用方法：

本小結介紹一般情況下輔助功能的使用（基礎用法和方法釋義較多，如果需要閱覽API > 20 新增方法使用請從2.2開始閱讀），API level在20及以下的使用方式。不涉及新增的方法以及類的使用介紹。

2.1.1 使用流程：

1、Service: 配置自己的輔助功服務（註冊、配置）

2、Class: 自己的輔助功能類（對事件的攔截、處理）

2.1.2 Service配置：

1、在例項化的輔助功能類中：onServiceConnected()中初始化，如下所示。

@Override
protected void onServiceConnected() {
    super.onServiceConnected();
    AccessibilityServiceInfo info = new AccessibilityServiceInfo();
    info.eventTypes = AccessibilityEvent.TYPES_ALL_MASK;
    info.feedbackType = AccessibilityServiceInfo.FEEDBACK_GENERIC;
    info.notificationTimeout = 100;
    info.packageNames = new String[]{"...", "..."};
    info.flags = AccessibilityServiceInfo.FLAG_REPORT_VIEW_IDS;
    setServiceInfo(info);
}
 

2、使用manifest中新增meta-data的方式（該方式從API 14開始使用）

<?xml version="1.0" encoding="utf-8"?>
<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:accessibilityEventTypes=""
    android:accessibilityFeedbackType=""
    android:accessibilityFlags=""
    android:canRequestEnhancedWebAccessibility=""
    android:canRequestFilterKeyEvents=""
    android:canRequestTouchExplorationMode=""
    android:canRetrieveWindowContent=""
    android:description=""
    android:notificationTimeout=""
    android:packageNames=""
    android:settingsActivity=""
    android:summary="" />
 

由上邊兩組程式碼可以看到，前一個配置中單個程式碼塊中，配置屬性有限，但靈活的在服務裡邊初始化，使我們可以隨時的改變需要的flag和type及一些其他引數。而後一個（Android 4.0+ / API 14+）的meta-data配置方式，可配置的屬性更多。在系統條件符合時（同時不需要更改我們輔助功能的一些引數時），還是推薦使用後一個配置方式進行輔助功能的配置。

這裡只是對所有的XML attributes進行說明。

XML attributes：

• accessibilityFlags 輔助功能附加的標誌，多個使用 ' | '分隔

• canRequestEnhancedWebAccessibility (boolean)
  輔助功能服務是否能夠請求WEB輔助增強的屬性。例如: 安裝指令碼以使應用程式內容更易於訪問。

• canRequestFilterKeyEvents (boolean)
  輔助功能服務是否能夠請求過濾KeyEvent的屬性，是否可以請求KeyEvent事件流。，flagRequestFilterKeyEvents搭配使用

• canRequestTouchExplorationMode (boolean)
  此屬性用於，能夠讓輔助功能服務通過手勢，來請求觸控瀏覽模式，其被觸控的項，將被朗讀出來，flagRequestTouchExplorationMode搭配使用

• canRetrieveWindowContent (boolean)
  輔助功能服務是否能夠取回活動視窗內容的屬性。 與上邊的flagRetrieveInteractiveWindows搭配使用，無法在執行時更改此設定。

• description
  輔助功能服務目的或行為的簡短描述。

• notificationTimeout
  同一型別的兩個輔助功能事件傳送到服務的最短間隔（毫秒，兩個輔助功能事件之間的最小週期）

• packageNames
  從此服務能接收到事件的軟體包名稱 (不適合所有軟體包)（多個軟體包用逗號分隔）。

• settingsActivity
  允許使用者修改輔助功能的activity元件名稱

• summary
  同description

2.1.4 實現自己的輔助功能類：

Public方法有：

這部分我們只針對API <= 20部分的程式碼，其中我們常用的方法有：

在使用這些方法時，有三個需要我們瞭解的地方：

• AccessibilityEvent 在輔助功能event回撥方法中，返回的引數。（官方API En）

• AccessibilityNodeInfo 輔助功能中的節點物件(nodeInfo)。（官方API En）

• performGlobalAction(action) 全域性事件傳送方法（物理按鍵的點選）

AccessibilityEvent

當用戶介面發生某些明顯的事件時，AccessibilityEvent代表的無障礙事件會被系統傳送，每一種事件型別是由該類暴露出的屬性子集表示其特徵的。在此類中為每一種事件型別定義了相應的常量。詳細的事件型別請參照AccessibilityEvent文件 Zh。

Public Methods 公有方法:

AccessibilityNodeInfo

該類代表一個視窗內容節點和可以從源請求的操作。從 AccessibilityService的角度看，一個視窗內容被呈現為一個無障礙節點資訊樹，該樹可能與檢視層次一一對映，也可能不與檢視層次一一對映。換句話說，一個自定義檢視可靈活地將自己報告為一個無障礙節點資訊樹。一旦無障礙節點資訊被髮送給無障礙服務，該資訊將會是不可改變的，且呼叫狀態改變方法將會產生錯誤。AccessibilityNodeInfo文件 Zh

巢狀類：

常量：
使用nodeInfo.performAction(Int Action)、performAction(Int Action, Bundle bundle)方法

方法：

performGlobalAction

2.1.5 自定義AccessibilityService類的常規使用

public class MyAccessibilityService extends AccessibilityService {

    @Override
    protected void onServiceConnected() {
        super.onServiceConnected();
    }

    @Override
    public void onAccessibilityEvent(AccessibilityEvent event) {
        // 1.AccessibilityEvent中一些常用的使用方法
        // 這裡我們獲取到該輔助功能的事件型別
        // 事件型別請參照 2.1.3中AccessibilityEventTypes表
        int eventType = event.getEventType();
        // 輸出事件的字串type
        String typeStr = event.eventTypeToString(eventType);
        // 根據事件型別來分發我們的需要的操作,這裡以視窗變化為例
        if(AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED == eventType){
            // 判斷我們的輔助功能是否在約定好的應用介面執行，以設定介面為例
            if("com.android.settings".equals(event.getPackageName()){
                // doSomeThing
            }
        } else if(AccessibilityEvent.TYPE_GESTURE_DETECTION_START == eventType) {
            // 在監測到手勢的時候
        } else {
            // 在完成操作時，可以關閉自己的服務，下次使用再次開啟。
            // API > = 24
            disableSelf();
        }

        // 2.通過event來遍歷我們的nodeInfo
        if (VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR2)
            // 這裡使用getResource()方法其實是從AccessibilityEvent繼承的
            // AccessibilityRecord中抽取AccessibilityNodeInfo
            // 實際呼叫的是AccessibilityRecord中的方法，返回的是AccessibilityNodeInfo mSourceNode
            AccessibilityNodeInfo info = event.getSource();
        else
            info = getRootInActiveWindow();

        // 3.遍歷info中的子節點
        if (info.getChildCount() ！= 0){
            // 通過一個迴圈將info的子節點遍歷
            for (int i = 0; i < info.getChildCount(); i++) {
                // 獲取子節點中某個特定的node，這裡通過以下方法通過ID查詢
                List<AccessibilityNodeInfo> list = info.findAccessibilityNodeInfosByViewId("com.android" +".settings:id/xxxx");
                // 通過text查詢
                List<AccessibilityNodeInfo> list = info.findAccessibilityNodeInfosByText("xxxx");
                // 列印nodeinfo的資訊
                Log.e("InfoType: " + info.getClassName());
                Log.e("InfoText: " + info.getText());
                Log.e("InfoPkgName: " + info.getPackageName());
                Log.e("InfoViewId: " + info.getViewIdResourceName());
            }
        }

        // 4.為節點新增操作
        // 1) 首先獲取到我們的節點
        AccessibilityNodeInfo info = event.getSource();
        // 2) 通過查詢指定的ID、text來查詢一個系列的節點，返回一個list，需要判斷list.size()是否為空
        List<AccessibilityNodeInfo> list = info.findAccessibilityNodeInfosByViewId("pkgName." + "id");
        AccessibilityNodeInfo info = list.get(0);
        // 3) 為節點新增操作，點選事件（事件可參照AccessibilityNodeInfo表）
        info.performAction(AccessibilityNodeInfo.ACTION_CLICK);
        // 4) 新增node可用的action，給node新增一個可清除焦點的操作
        // 通過addAction(AccessibilityNodeInfo.AccessibilityAction action)
        info.addAction(AccessibilityNodeInfo.AccessibilityAction.ACTION_CLEAR_FOCUS);
        // 獲取該node上可用的action屬性list，可以用來檢視該node的屬性
        List<AccessibilityNodeInfo.AccessibilityAction> listAction = info.getActionList();

        // 5.獲取該節點上子節點個數
        int childCount = info.getChildCount();

        // 6.操作完成後，回收例項，返回一個下次可用的例項
        info.recycle();

        // 需要注意的是，在node.performAction之後，呼叫本地廣播的話，之後的globeAction不會起作用，例：
        sureStopNode.performAction(AccessibilityNodeInfo.ACTION_CLICK);
        sureStopNode.recycle();
        SystemMessage.getInstance().send(SystemMessage.ACTION_POWER_BOOSTER_NEXT);
        performGlobalAction();// 這句話是不起作用的

        // 7.輔助功能的一些適用場景：
        // 1)部分應用中獲取簡訊驗證碼（通過開啟輔助功能的方式獲取）
        //  - 監聽通知欄的訊息(typeNotificationStateChanged)
        //  - 彈出通知欄的時候獲取該通知的節點資訊(event.getSource())
        //  - 遍歷root節點，取得顯示資訊的文字Node(info.findAccessibilityNodeInfosByViewId("pkgName." + "id"))
        //  - 通過NodeInfo.getText()方法獲取到相應的文字資訊，並取出驗證碼
        //  - 取消掉通知欄彈出框
        //  - 獲取到要輸入的EditText獲取直接在本應用給需要填寫驗證碼的區域設定文字。

        // 2)部分應用中恢復APP的初始設定（清除APP的資料）
        //  - 跳轉到應用詳情，通過findAccessibilityNodeInfosByViewId查詢節點
        //  - 通過節點info.performAction(AccessibilityNodeInfo.ACTION_CLICK)點選清除
        //  - 彈出確定對話方塊，同上方式找到確定節點，點選後返回

        // 3)監測應用是否在前臺，APP的啟動（通過windowstatechange事件獲取到當前的event的pkgName）
        //  - 通過接收typeWindowStateChanged事件，獲取event的pkgName確定哪個應用啟動或者在最上層顯示（懸浮窗不適用）

        // 4)自動安裝與解除安裝軟體
        //  - 同3，尋找相應的節點，點選事件

        // 5)自動化UI測試

        // 6)最常見的搶紅包

        // 7)通過輔助功能開啟一些許可權(不需要使用者手動點選開啟了)
        //  - 在使用者確定需要開啟許可權時，自動跳轉，尋找相應的開關按鈕
        //  - 需要注意的是，部分開關（switch button， checkbox）可能沒有ID，需要通過info.getClassName()來判斷，屬於那種型別的view。
    }

    @Override
    public void onInterrupt() {
    }

}

需要重寫的一些方法：

• onServiceConnected() 該方法在初始化輔助功能服務時呼叫，可以在這時做相應的初始化工作。
• onAccessibilityEvent() 在獲取到指定的監聽事件時，通過回撥這個方法來進行對應的操作
• onInterrupt() 系統想要中斷輔助功能時會呼叫該方法

當然service中的onUnbind()方法也同樣適用，在onUnbind()中釋放一些資源也是可以的。

Note: 這裡需要了解的是輔助功能最重要的就是手機機型的適配。由於各個廠商的系統不一樣，導致了我們在獲取一些節點時，需要的節點ID不同（通過ID獲取節點時一種比較高效的方式）。而我們一般通過Device Monitor中的Hierarchy View獲取節點資訊。同時在此方式下，很多手機沒法獲取到節點資訊，我們就需要使用新增flagReportViewIds進行手動遍歷介面節點的方式獲取nodeInfo。

以上是輔助功能常規使用以及使用場景的介紹。下面為輔助功能的註冊。

<service
    android:name=".我們自己繼承自AccessibilityService的類"
        android:label="@string/app_name"
        android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE">
        <intent-filter>
            <action android:name="android.accessibilityservice.AccessibilityService"/>
        </intent-filter>

        <meta-data
            android:name="android.accessibilityservice"
            android:resource="@xml/第二個輔助功能配置方式的檔案，存放在xml下"/>
</service>

2.2 API > 20 新增方法，介面（預覽版）使用探究：

2.2.1 AccessibilityService新增方法一覽：

API 21：

獲取螢幕上的視窗。
返回一個有目標的使用者可以與之進行互動的視窗，而不是所有的視窗。

為了訪問Windows，服務必須通過在其元資料中設定AccessibilityService_canRetrieveWindowContent屬性來宣告檢索視窗內容的功能。此外，服務必須選擇通過設定FLAG_RETRIEVE_INTERACTIVE_WINDOWS標誌來檢索互動式視窗。

使用此方法來獲取我們螢幕上最上層的一個視窗根節點。

API 24：

返回AccessibilityService.SoftKeyboardController其中可以使用新增addOnShowModeChangedListener()的方式來進行對鍵盤的顯示隱藏狀態監聽，通過getShowMode()獲取到軟鍵盤的顯示隱藏狀態，setShowMode(int showMode)設定軟鍵盤的顯示隱藏狀態。

通過在服務中呼叫該方法可以將自己的服務停止，同時在輔助功能開啟介面上的開關也會隨之關閉。

可以通過設定GestureDescription將手勢的軌跡顯示在觸控式螢幕上，同時可以通過GestureResultCallback回撥獲得事件的完成情況。

這裡的焦點型別有FOCUS_INPUT和FOCUS_ACCESSIBILITY分別代表了輸入焦點和無障礙重點。
FOCUS_ACCESSIBILITY這個焦點，是需要使用setAccessibilityFocused(boolean isFocus)方法進行設定過得焦點。

需要注意的是：如果要使用該方法的話，需要先設定AccessibilityService_canRetrieveWindowContent同時新增一個flag：FLAG_RETRIEVE_INTERACTIVE_WINDOWS。

返回：AccessibilityService.MagnificationController。為了控制放大倍數，輔助功能服務必須通過在其元資料中設定AccessibilityService_canControlMagnification屬性來宣告該功能。

API 26：

當設定FLAG_REQUEST_ACCESSIBILITY_BUTTON時，此類可用於查詢輔助功能按鈕的狀態並註冊回撥以進行互動，並對可訪問性按鈕進行狀態更改。

注意：此類和FLAG_REQUEST_ACCESSIBILITY_BUTTON不應該被用作通過AccessibilityService為使用者提供功能的唯一手段。 一些裝置實現可以選擇不提供軟體呈現的系統導航區域，使得該功能永久不可用。

注意：在支援輔助功能按鈕的裝置實現中，它可能始終不可用，例如前臺應用程式使用SYSTEM_UI_FLAG_HIDE_NAVIGATION時。 使用者還可以選擇將該按鈕分配給另一個可訪問性服務或功能。 在每種情況下，將呼叫註冊的AccessibilityButtonController.AccessibilityButtonCallback的onAvailabilityChanged（AccessibilityButtonController，boolean）方法來提供對可訪問性按鈕對註冊服務的可用性的更改的通知。

注意底部導航欄的小人：

下面是一個簡單的用例：

public class MyAccessibilityService extends AccessibilityService {

    @Override
    protected void onServiceConnected() {
        super.onServiceConnected();
        AccessibilityServiceInfo info = new AccessibilityServiceInfo();
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            info.flags = AccessibilityServiceInfo.FLAG_REQUEST_ACCESSIBILITY_BUTTON;
        } else {
            info.flags = AccessibilityServiceInfo.FLAG_REPORT_VIEW_IDS;
        }
        info.eventTypes = AccessibilityEvent.TYPES_ALL_MASK;
        info.feedbackType = AccessibilityServiceInfo.FEEDBACK_GENERIC;
        info.notificationTimeout = 100;
        setServiceInfo(info);
    }

    @Override
    public void onAccessibilityEvent(AccessibilityEvent event) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            AccessibilityButtonController mAccessibilityButtonController = getAccessibilityButtonController();
            mAccessibilityButtonController.registerAccessibilityButtonCallback(new AccessibilityButtonController.AccessibilityButtonCallback() {
                @Override
                public void onClicked(AccessibilityButtonController controller) {
                    super.onClicked(controller);
                    // 底部導航欄中輔助功能按鈕點選事件回撥
                    Toast.makeText(MyAccessibilityService.this, "on Click", Toast.LENGTH_SHORT).show();
                }

                @Override
                public void onAvailabilityChanged(AccessibilityButtonController controller, boolean available) {
                    super.onAvailabilityChanged(controller, available);
                    // 輔助功能可用性改變的回撥。返回了輔助功能底部按鈕是否可用的布林值，和按鈕控制器
                    // available = true 表示該按鈕對本服務可用
                    // available = false 是由於裝置顯示了按鈕，或按鈕被分配到另一個服務或其他原因。
                }
            });
        }
    }

    @Override
    public void onInterrupt() {
    }
}

在開啟輔助功能之後，如果是O系統的話，在底部導航欄會出現一個輔助功能的小人。同時這個小人可以接收到點選事件，和輔助功能可用狀態變化。

只要裝置具有能夠檢測手勢的感測器，AccessibilityService可以捕獲在裝置的指紋感測器上執行的手勢。
使用時需要宣告CAPABILITY_CAN_CAPTURE_FINGERPRINT_GESTURES同時需要許可權USE_FINGERPRINT,由於沒有真機除錯該方法，待Google釋出正式版API後繼續研究

支援的四個事件:

公有方法

2.2.1 AccessibilityNodeInfo新增方法一覽：

API 21

以上兩個方法需要搭配使用。

通過該方法，我們可以使用一個子節點來重新獲取到我們的根節點。在需要多次操作介面元素的情況下（同時沒有產生windowstatechange事件），我們可以不通過監聽事件來進行下一個節點的操作。

第一個addAction(AccessibilityNodeInfo.AccessibilityAction action)方法是API 21時替代API 20中的addAction(int action)方法。
提供了一個在輔助功能外操作節點的方法，該方法不能在輔助功能服務中呼叫，不然會報錯java.lang.IllegalStateException: Cannot perform this action on a sealed instance.

後三個方法使用的前提都是需要事先在節點中添加了操作，或者檢視，不然都不會起作用。要說明的是removeAction方法也需要在服務外呼叫，不然也要報錯

API 22

通過在view的xml屬性中新增android:accessibilityTraversalAfter="+id"方式來進行輔助功能遍歷時的順序後，通過本方法獲取下一個節點。

通過在view的xml屬性中新增android:accessibilityTraversalBefore="+id"方式來進行輔助功能遍歷時的順序，同上。

通過View.setAccessibilityTraversalBefore(+id)方