語言

AccessibilityServiceFlags 列舉

定義

列舉由多種類型回傳的值,並作為 成員的參數。

此列舉支援其成員值的位元組合。

[System.Flags]
public enum AccessibilityServiceFlags
[<System.Flags>]
type AccessibilityServiceFlags = 
繼承
AccessibilityServiceFlags
屬性

欄位

名稱 值 Description
Default 1

如果 是 AccessibilityService某個類型的預設值。 只有當沒有套件特定的預設服務時才會被呼叫。

IncludeNotImportantViews 2

若設定此標記,系統會考慮對無障礙不重要的視角與對無障礙重要的視角。

RequestTouchExplorationMode 4

此旗標要求系統進入觸控探索模式。 在此模式下,螢幕上移動的單指會像滑鼠指標一樣懸停在使用者介面上。

RequestEnhancedWebAccessibility 8

此旗標會向系統請求啟用網頁無障礙增強擴充功能。

ReportViewIds 16

此旗標要求 AccessibilityService 取得的 AccessibilityNodeInfos 包含原始檢視的 ID。 原始檢視 ID 會是完全限定的資源名稱,格式為「package:id/name」,例如「foo.bar:id/my_list」,對 UI 測試自動化非常有用。 此旗標並非預設設定。

Android 參考資料。android.accessibilityservice.AccessibilityServiceInfo.FLAG_REPORT_VIEW_IDS

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

RequestFilterKeyEvents 32

此旗標會向系統請求過濾關鍵事件。

RetrieveInteractiveWindows 64

此旗標向系統表示無障礙服務希望存取所有互動視窗的內容。 互動視窗是指在未啟用觸控探索時,有視力的使用者可以觸摸到輸入焦點或可觸碰的視窗。 若未設定此標誌,您的服務將不會收到AccessibilityEvent.TYPE_WINDOWS_CHANGED事件,呼叫 AccessibilityService.getWindows() 會回傳空清單,而 AccessibilityNodeInfo.getWindow() 則會回傳 null。

想要設定此標誌的服務必須宣告能在其元資料中擷取視窗內容的能力,並將屬性 canRetrieveWindowContent 設為 true,否則此標記將被忽略。 關於如何宣告服務的元資料,請參考AccessibilityService.SERVICE_META_DATA。

Android 參考資料。android.accessibilityservice.AccessibilityServiceInfo.FLAG_RETRIEVE_INTERACTIVE_WINDOWS

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

EnableAccessibilityVolume 128

此旗標要求系統範圍內所有音軌與AudioAttributes.USAGE_ASSISTANCE_ACCESSIBILITY由AudioManager.STREAM_ACCESSIBILITY音量控制。

Android 參考資料。android.accessibilityservice.AccessibilityServiceInfo.FLAG_ENABLE_ACCESSIBILITY_VOLUME

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

RequestAccessibilityButton 256

此旗標指示系統無障礙服務要求在導航區域內顯示無障礙按鈕(若有的話)。

注意:針對超過 API 29 的無障礙服務,必須在無障礙服務的元資料檔案中指定此標誌。 否則,它將被忽視。

Android 參考資料。android.accessibilityservice.AccessibilityServiceInfo.FLAG_REQUEST_ACCESSIBILITY_BUTTON

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

RequestFingerprintGestures 512

此旗標要求所有指紋手勢都傳送至無障礙服務。

想要設定此標誌的服務必須宣告能在其元資料中檢索視窗內容的能力,並將屬性 R.attr.canRequestFingerprintGestures 設為 true,否則此標記將被忽略。 關於如何宣告服務的元資料,請參考AccessibilityService.SERVICE_META_DATA。

Android 參考資料。android.accessibilityservice.AccessibilityServiceInfo.FLAG_REQUEST_FINGERPRINT_GESTURES

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

RequestShortcutWarningDialogSpokenFeedback 1024

此旗標要求無障礙捷徑警告對話框在對話顯示時有語音回饋。

Android 參考資料。android.accessibilityservice.AccessibilityServiceInfo.FLAG_REQUEST_SHORTCUT_WARNING_DIALOG_SPOKEN_FEEDBACK

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

ServiceHandlesDoubleTap 2048

此旗標請求啟用 FLAG_REQUEST_TOUCH_EXPLORATION_MODE 時,雙重點擊及雙重點擊並按住的手勢會被派遣給服務,而非由框架處理。 如果FLAG_REQUEST_TOUCH_EXPLORATION_MODE被停用,這個旗標就不會生效。

Android 參考資料。android.accessibilityservice.AccessibilityServiceInfo.FLAG_SERVICE_HANDLES_DOUBLE_TAP

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

RequestMultiFingerGestures 4096

此旗標要求啟用 FLAG_REQUEST_TOUCH_EXPLORATION_MODE 時,也啟用多指手勢。 因此,兩指繞過手勢將被停用。 如果FLAG_REQUEST_TOUCH_EXPLORATION_MODE被停用,這個旗標就不會生效。

Android 參考資料。android.accessibilityservice.AccessibilityServiceInfo.FLAG_REQUEST_MULTI_FINGER_GESTURES

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

RequestTwoFingerPassthrough 8192

此旗標請求啟用 FLAG_REQUEST_MULTI_FINGER_GESTURES 時,重新啟用兩指直通手勢。 兩指滑動手勢不會被偵測到,而是以單指手勢通過。 此外,從螢幕底部用三指滑動時不會被偵測到,而是直接通過,且不改變。 如果FLAG_REQUEST_MULTI_FINGER_GESTURES被停用,這個旗標就不會生效。

Android 參考資料。android.accessibilityservice.AccessibilityServiceInfo.FLAG_REQUEST_2_FINGER_PASSTHROUGH

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

SendMotionEvents 16384

此旗標請求啟用 FLAG_REQUEST_TOUCH_EXPLORATION_MODE 時,服務將接收每個成功偵測到的動作事件。 服務也會根據每個取消的手勢及其動態事件,獲得類型為GESTURE_INVALID的無障礙手勢事件。 服務會收到一個類型為GESTURE_PASSTHROUGH的手勢,並伴隨動作事件,且每個未啟動手勢偵測的直通手勢。 這些資訊可用來收集不當手勢偵測行為的實例,並將這些資訊傳達給框架開發者。 如果FLAG_REQUEST_TOUCH_EXPLORATION_MODE被停用,這個旗標就不會生效。

Android 參考資料。android.accessibilityservice.AccessibilityServiceInfo.FLAG_SEND_MOTION_EVENTS

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

FlagInputMethodEditor 32768

此標誌使 AccessibilityService 成為輸入法編輯器,具備部分輸入法編輯器功能:取得 InputConnection 及取得文字選擇變更通知。

Android 參考資料。android.accessibilityservice.AccessibilityServiceInfo.FLAG_INPUT_METHOD_EDITOR

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

備註

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於