public final class AccessibilityServiceInfoCompat
extends Object
java.lang.Object | |
↳ | android.support.v4.accessibilityservice.AccessibilityServiceInfoCompat |
Helper用于访问在向后兼容的API级别4后引入的 AccessibilityService
功能。
Constants |
|
---|---|
int |
CAPABILITY_CAN_FILTER_KEY_EVENTS 能力:此可访问性服务可以过滤关键事件流。 |
int |
CAPABILITY_CAN_REQUEST_ENHANCED_WEB_ACCESSIBILITY 功能:此辅助功能服务可以请求增强的Web辅助功能增强功能。 |
int |
CAPABILITY_CAN_REQUEST_TOUCH_EXPLORATION 能力:这种可访问性服务可以请求触摸探索模式,在这种模式下可以大声说出触摸项目,并且可以通过手势探索UI。 |
int |
CAPABILITY_CAN_RETRIEVE_WINDOW_CONTENT 功能:此可访问性服务可以检索活动窗口内容。 |
int |
DEFAULT 如果 |
int |
FEEDBACK_ALL_MASK 所有反馈类型的掩码。 |
int |
FEEDBACK_BRAILLE 表示盲文反馈。 |
int |
FLAG_INCLUDE_NOT_IMPORTANT_VIEWS 如果设置了这个标志,系统会将对可访问性不重要的视图添加到对可访问性非常重要的视图之外。 |
int |
FLAG_REPORT_VIEW_IDS 此标志请求由 |
int |
FLAG_REQUEST_ENHANCED_WEB_ACCESSIBILITY 此标志请求系统启用Web可访问性增强扩展。 |
int |
FLAG_REQUEST_FILTER_KEY_EVENTS 该标志请求系统过滤关键事件。 |
int |
FLAG_REQUEST_TOUCH_EXPLORATION_MODE 该标志要求系统进入触摸探索模式。 |
Public methods |
|
---|---|
static String |
capabilityToString(int capability) 返回一个功能的字符串表示。 |
static String |
feedbackTypeToString(int feedbackType) 返回反馈类型的字符串表示形式。 |
static String |
flagToString(int flag) 返回标志的字符串表示形式。 |
static boolean |
getCanRetrieveWindowContent(AccessibilityServiceInfo info) 此服务是否可以检索当前窗口的内容。 |
static int |
getCapabilities(AccessibilityServiceInfo info) 返回此可访问性服务具有的功能的位掩码,例如能够检索活动窗口内容等。 |
static String |
getDescription(AccessibilityServiceInfo info) 无障碍服务的描述。 |
static String |
getId(AccessibilityServiceInfo info) 无障碍服务ID。 |
static ResolveInfo |
getResolveInfo(AccessibilityServiceInfo info) 服务 |
static String |
getSettingsActivityName(AccessibilityServiceInfo info) 设置活动名称。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
int CAPABILITY_CAN_FILTER_KEY_EVENTS
能力:此可访问性服务可以过滤关键事件流。
常量值:8(0x00000008)
int CAPABILITY_CAN_REQUEST_ENHANCED_WEB_ACCESSIBILITY
功能:此辅助功能服务可以请求增强的Web辅助功能增强功能。 例如,安装脚本以使应用内容更易于访问。
常量值:4(0x00000004)
int CAPABILITY_CAN_REQUEST_TOUCH_EXPLORATION
能力:这种可访问性服务可以请求触摸探索模式,在这种模式下可以大声说出触摸项目,并且可以通过手势探索UI。
常量值:2(0x00000002)
int CAPABILITY_CAN_RETRIEVE_WINDOW_CONTENT
功能:此可访问性服务可以检索活动窗口内容。
常数值:1(0x00000001)
int DEFAULT
如果AccessibilityService
是给定类型的默认值。 只有在不存在特定软件包的情况下才会调用默认服务。 如果有多个特定于包的服务,则仅通知先前注册的服务。
常数值:1(0x00000001)
int FEEDBACK_ALL_MASK
所有反馈类型的掩码。
也可以看看:
常量值:-1(0xffffffff)
int FEEDBACK_BRAILLE
表示盲文反馈。
常量值:32(0x00000020)
int FLAG_INCLUDE_NOT_IMPORTANT_VIEWS
如果设置了这个标志,系统会将对可访问性不重要的视图添加到对可访问性非常重要的视图之外。 也就是说,通过IMPORTANT_FOR_ACCESSIBILITY_NO
或IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS
标记为对辅助功能IMPORTANT_FOR_ACCESSIBILITY_AUTO
以及系统已确定对辅助功能IMPORTANT_FOR_ACCESSIBILITY_AUTO
标记为可访问性重要的视图都将在查询窗口内容和无障碍服务也将从他们那里接收无障碍事件。
注意:对于定位API版本JELLY_BEAN
或更高版本的辅助功能服务,必须为系统明确设置此标志,以便JELLY_BEAN
辅助功能JELLY_BEAN
。 对于定位API版本低于JELLY_BEAN
辅助功能服务,此标志将被忽略,并且所有视图都将被视为可访问性目的。
通常对可访问性来说不重要的视图是布局管理器,它们不会对用户操作做出反应,不会绘制任何内容,并且在屏幕内容的上下文中没有任何特殊的语义。 例如,三乘三网格可以实现为三个水平线性布局和一个垂直线或三个垂直线性布局和一个水平布局或一个网格布局等等。在这种情况下,用于实现网格配置的实际布局管理器是不重要,重要的是有九个均匀分布的元素。
常量值:2(0x00000002)
int FLAG_REPORT_VIEW_IDS
此标志请求由AccessibilityService
获取的AccessibilityService
包含源视图的标识。 源视图ID将是“package:id / name”形式的完全限定资源名称,例如“foo.bar:id / my_list”,并且它对UI测试自动化很有用。 该标志未被默认设置。
常量值:16(0x00000010)
int FLAG_REQUEST_ENHANCED_WEB_ACCESSIBILITY
此标志请求系统启用Web可访问性增强扩展。 此类扩展旨在为WebView
呈现的内容提供改进的可访问性支持。 这种扩展的一个例子是从安全源注入JavaScript。 如果至少有一个设置了此标志的辅助功能服务,系统将启用增强的Web辅助功能。 因此,清除此标志并不能保证设备不会启用增强的Web访问权限,因为可能有另一个请求它的已启用服务。
想要设置此标志的服务必须通过将属性canRequestEnhancedWebAccessibility设置为true来在其元数据中声明此功能,否则此标志将被忽略。 有关如何声明服务的元数据,请参阅AccessibilityService.SERVICE_META_DATA
。
常量值:8(0x00000008)
int FLAG_REQUEST_FILTER_KEY_EVENTS
该标志请求系统过滤关键事件。 如果设置了此标志,则辅助功能服务将在应用程序允许其实施全局快捷方式之前收到关键事件。 设置此标志并不能保证此服务将过滤关键事件,因为在任何给定的时间只有一个服务可以这样做。 这可以避免用户在启用不同的密钥过滤服务的情况下由于行为改变而感到困惑。 如果已启用另一个密钥过滤服务,则此密钥过滤服务不会接收关键事件。
想要设置此标志的服务必须通过将属性canRequestFilterKeyEvents设置为true来在其元数据中声明此功能,否则该标志将被忽略。 有关如何声明服务的元数据,请参阅AccessibilityService.SERVICE_META_DATA
。
常量值:32(0x00000020)
int FLAG_REQUEST_TOUCH_EXPLORATION_MODE
该标志要求系统进入触摸探索模式。 在这种模式下,在屏幕上移动的单个手指就像鼠标悬停在用户界面上一样。 系统还会检测触摸屏上执行的某些手势并通知此服务。 如果至少有一个设置了此标志的辅助功能服务,系统将启用触摸探索模式。 因此,清除此标志并不能保证设备不会处于联系探索模式,因为可能有其他启用的服务请求它。
对于定位API版本高于JELLY_BEAN_MR1
可访问性服务,要设置此标志,必须通过将属性canRequestTouchExplorationMode设置为true来在其元数据中声明此功能,否则此标志将被忽略。 有关如何声明服务的元数据,请参阅AccessibilityService.SERVICE_META_DATA
。
定位API版本等于或低于 JELLY_BEAN_MR1
将正常运行,即第一次运行时,如果指定了此标志,则会向用户显示一个对话框,以确认是否允许通过触摸进行探索。
常量值:4(0x00000004)
String capabilityToString (int capability)
返回一个功能的字符串表示。 例如, CAPABILITY_CAN_RETRIEVE_WINDOW_CONTENT
由字符串CAPABILITY_CAN_RETRIEVE_WINDOW_CONTENT表示。
Parameters | |
---|---|
capability |
int : The capability. |
Returns | |
---|---|
String |
The string representation. |
String feedbackTypeToString (int feedbackType)
返回反馈类型的字符串表示形式。 例如, FEEDBACK_SPOKEN
由字符串FEEDBACK_SPOKEN表示。
Parameters | |
---|---|
feedbackType |
int : The feedback type. |
Returns | |
---|---|
String |
The string representation. |
String flagToString (int flag)
返回标志的字符串表示形式。 例如, DEFAULT
由字符串DEFAULT表示。
Parameters | |
---|---|
flag |
int : The flag. |
Returns | |
---|---|
String |
The string representation. |
boolean getCanRetrieveWindowContent (AccessibilityServiceInfo info)
此服务是否可以检索当前窗口的内容。
从meta-data
静态设置。
Parameters | |
---|---|
info |
AccessibilityServiceInfo
|
Returns | |
---|---|
boolean |
True window content can be retrieved. |
int getCapabilities (AccessibilityServiceInfo info)
返回此可访问性服务具有的功能的位掩码,例如能够检索活动窗口内容等。
Parameters | |
---|---|
info |
AccessibilityServiceInfo : The service info whose capabilities to get. |
Returns | |
---|---|
int |
The capability bit mask. |
String getDescription (AccessibilityServiceInfo info)
无障碍服务的描述。
从meta-data
静态设置。
Parameters | |
---|---|
info |
AccessibilityServiceInfo
|
Returns | |
---|---|
String |
The description. |
String getId (AccessibilityServiceInfo info)
无障碍服务ID。
Generated by the system.
Parameters | |
---|---|
info |
AccessibilityServiceInfo
|
Returns | |
---|---|
String |
The id. |
ResolveInfo getResolveInfo (AccessibilityServiceInfo info)
服务 ResolveInfo
。
由系统生成。
Parameters | |
---|---|
info |
AccessibilityServiceInfo
|
Returns | |
---|---|
ResolveInfo |
The info. |
String getSettingsActivityName (AccessibilityServiceInfo info)
设置活动名称。
Statically set from meta-data
.
Parameters | |
---|---|
info |
AccessibilityServiceInfo
|
Returns | |
---|---|
String |
The settings activity name. |