Most visited

Recently visited

AccessibilityServiceInfoCompat

public final class AccessibilityServiceInfoCompat
extends Object

java.lang.Object
   ↳ android.support.v4.accessibilityservice.AccessibilityServiceInfoCompat


Helper用于访问在向后兼容的API级别4后引入的 AccessibilityService功能。

Summary

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

如果 AccessibilityService是给定类型的默认值。

int FEEDBACK_ALL_MASK

所有反馈类型的掩码。

int FEEDBACK_BRAILLE

表示盲文反馈。

int FLAG_INCLUDE_NOT_IMPORTANT_VIEWS

如果设置了这个标志,系统会将对可访问性不重要的视图添加到对可访问性非常重要的视图之外。

int FLAG_REPORT_VIEW_IDS

此标志请求由 AccessibilityService获取的 AccessibilityService包含源视图的ID。

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)

服务 ResolveInfo

static String getSettingsActivityName(AccessibilityServiceInfo info)

设置活动名称。

Inherited methods

From class java.lang.Object

Constants

CAPABILITY_CAN_FILTER_KEY_EVENTS

int CAPABILITY_CAN_FILTER_KEY_EVENTS

能力:此可访问性服务可以过滤关键事件流。

常量值:8(0x00000008)

CAPABILITY_CAN_REQUEST_ENHANCED_WEB_ACCESSIBILITY

int CAPABILITY_CAN_REQUEST_ENHANCED_WEB_ACCESSIBILITY

功能:此辅助功能服务可以请求增强的Web辅助功能增强功能。 例如,安装脚本以使应用内容更易于访问。

常量值:4(0x00000004)

CAPABILITY_CAN_REQUEST_TOUCH_EXPLORATION

int CAPABILITY_CAN_REQUEST_TOUCH_EXPLORATION

能力:这种可访问性服务可以请求触摸探索模式,在这种模式下可以大声说出触摸项目,并且可以通过手势探索UI。

常量值:2(0x00000002)

CAPABILITY_CAN_RETRIEVE_WINDOW_CONTENT

int CAPABILITY_CAN_RETRIEVE_WINDOW_CONTENT

功能:此可访问性服务可以检索活动窗口内容。

常数值:1(0x00000001)

DEFAULT

int DEFAULT

如果AccessibilityService是给定类型的默认值。 只有在不存在特定软件包的情况下才会调用默认服务。 如果有多个特定于包的服务,则仅通知先前注册的服务。

常数值:1(0x00000001)

FEEDBACK_ALL_MASK

int FEEDBACK_ALL_MASK

所有反馈类型的掩码。

也可以看看:

常量值:-1(0xffffffff)

FEEDBACK_BRAILLE

int FEEDBACK_BRAILLE

表示盲文反馈。

常量值:32(0x00000020)

FLAG_INCLUDE_NOT_IMPORTANT_VIEWS

int FLAG_INCLUDE_NOT_IMPORTANT_VIEWS

如果设置了这个标志,系统会将对可访问性不重要的视图添加到对可访问性非常重要的视图之外。 也就是说,通过IMPORTANT_FOR_ACCESSIBILITY_NOIMPORTANT_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)

FLAG_REPORT_VIEW_IDS

int FLAG_REPORT_VIEW_IDS

此标志请求由AccessibilityService获取的AccessibilityService包含源视图的标识。 源视图ID将是“package:id / name”形式的完全限定资源名称,例如“foo.bar:id / my_list”,并且它对UI测试自动化很有用。 该标志未被默认设置。

常量值:16(0x00000010)

FLAG_REQUEST_ENHANCED_WEB_ACCESSIBILITY

int FLAG_REQUEST_ENHANCED_WEB_ACCESSIBILITY

此标志请求系统启用Web可访问性增强扩展。 此类扩展旨在为WebView呈现的内容提供改进的可访问性支持。 这种扩展的一个例子是从安全源注入JavaScript。 如果至少有一个设置了此标志的辅助功能服务,系统将启用增强的Web辅助功能。 因此,清除此标志并不能保证设备不会启用增强的Web访问权限,因为可能有另一个请求它的已启用服务。

想要设置此标志的服务必须通过将属性canRequestEnhancedWebAccessibility设置为true来在其元数据中声明此功能,否则此标志将被忽略。 有关如何声明服务的元数据,请参阅AccessibilityService.SERVICE_META_DATA

常量值:8(0x00000008)

FLAG_REQUEST_FILTER_KEY_EVENTS

int FLAG_REQUEST_FILTER_KEY_EVENTS

该标志请求系统过滤关键事件。 如果设置了此标志,则辅助功能服务将在应用程序允许其实施全局快捷方式之前收到关键事件。 设置此标志并不能保证此服务将过滤关键事件,因为在任何给定的时间只有一个服务可以这样做。 这可以避免用户在启用不同的密钥过滤服务的情况下由于行为改变而感到困惑。 如果已启用另一个密钥过滤服务,则此密钥过滤服务不会接收关键事件。

想要设置此标志的服务必须通过将属性canRequestFilterKeyEvents设置为true来在其元数据中声明此功能,否则该标志将被忽略。 有关如何声明服务的元数据,请参阅AccessibilityService.SERVICE_META_DATA

常量值:32(0x00000020)

FLAG_REQUEST_TOUCH_EXPLORATION_MODE

int FLAG_REQUEST_TOUCH_EXPLORATION_MODE

该标志要求系统进入触摸探索模式。 在这种模式下,在屏幕上移动的单个手指就像鼠标悬停在用户界面上一样。 系统还会检测触摸屏上执行的某些手势并通知此服务。 如果至少有一个设置了此标志的辅助功能服务,系统将启用触摸探索模式。 因此,清除此标志并不能保证设备不会处于联系探索模式,因为可能有其他启用的服务请求它。

对于定位API版本高于JELLY_BEAN_MR1可访问性服务,要设置此标志,必须通过将属性canRequestTouchExplorationMode设置为true来在其元数据中声明此功能,否则此标志将被忽略。 有关如何声明服务的元数据,请参阅AccessibilityService.SERVICE_META_DATA

定位API版本等于或低于 JELLY_BEAN_MR1将正常运行,即第一次运行时,如果指定了此标志,则会向用户显示一个对话框,以确认是否允许通过触摸进行探索。

常量值:4(0x00000004)

Public methods

capabilityToString

String capabilityToString (int capability)

返回一个功能的字符串表示。 例如, CAPABILITY_CAN_RETRIEVE_WINDOW_CONTENT由字符串CAPABILITY_CAN_RETRIEVE_WINDOW_CONTENT表示。

Parameters
capability int: The capability.
Returns
String The string representation.

feedbackTypeToString

String feedbackTypeToString (int feedbackType)

返回反馈类型的字符串表示形式。 例如, FEEDBACK_SPOKEN由字符串FEEDBACK_SPOKEN表示。

Parameters
feedbackType int: The feedback type.
Returns
String The string representation.

flagToString

String flagToString (int flag)

返回标志的字符串表示形式。 例如, DEFAULT由字符串DEFAULT表示。

Parameters
flag int: The flag.
Returns
String The string representation.

getCanRetrieveWindowContent

boolean getCanRetrieveWindowContent (AccessibilityServiceInfo info)

此服务是否可以检索当前窗口的内容。

meta-data静态设置。

Parameters
info AccessibilityServiceInfo
Returns
boolean True window content can be retrieved.

getCapabilities

int getCapabilities (AccessibilityServiceInfo info)

返回此可访问性服务具有的功能的位掩码,例如能够检索活动窗口内容等。

Parameters
info AccessibilityServiceInfo: The service info whose capabilities to get.
Returns
int The capability bit mask.

也可以看看:

getDescription

String getDescription (AccessibilityServiceInfo info)

无障碍服务的描述。

meta-data静态设置。

Parameters
info AccessibilityServiceInfo
Returns
String The description.

getId

String getId (AccessibilityServiceInfo info)

无障碍服务ID。

Generated by the system.

Parameters
info AccessibilityServiceInfo
Returns
String The id.

getResolveInfo

ResolveInfo getResolveInfo (AccessibilityServiceInfo info)

服务 ResolveInfo

由系统生成。

Parameters
info AccessibilityServiceInfo
Returns
ResolveInfo The info.

getSettingsActivityName

String getSettingsActivityName (AccessibilityServiceInfo info)

设置活动名称。

Statically set from meta-data.

Parameters
info AccessibilityServiceInfo
Returns
String The settings activity name.

Hooray!