Android Accessibility : TalkBack的状态读取

碰到一个问题, 需要读取TalkBack的状态.

 

首先, 读了下TalkBack源码, 发现提供了一个StatusProvider. 于是可以这样读状态:

1. 这个StatusProvider是一个ContentProvider的实现;

2. 通过StatusProvider.query()可以查询TalkBack开启的状态.

    连接Provider的URI:

content://com.google.android.marvin.talkback.providers.StatusProvider

3. query返回一个StatusCursor(MatrixCursor的子类);

4. 这里有一个trick, 状态值不像一般读Cursor一样, moveToFirst, 然后getXXX().

    这里直接调用MatrixCursor.getInt(int), 其返回值即TalkBack开启状态, 该方法的参数随意, 不影响结果;

5. 返回值: 0x01 = TalkBack服务enabled; 0x02 = 服务disabled.

 

上述读取方法需要考虑以下细节:

1. StatusProvider.query()的查询过程, 不涉及数据库操作, 可以认为没有文件IO操作, 效率较高;

2. 某些手机中没有安装TalkBack(标准Android是预置的), 因此StatusProvider不一定能连接上, 这部分需要考虑容错.

 

======================== 代码看疯了的分割线 =======================

 

当觉得万事大吉之际, 发现一个问题: TalkBack的代码, 是在SVN管理的, 我读的代码, 是修订版本729. 729可能不是最新的TalkBack版本!

于是更新代码至最新, 发现TalkBack不包含在最新版本的代码中... 我X

经过一番查找, TalkBack最后一版在修订版本743下.

SVN地址(Across the Great Wall we can reach every corner in the world.): 

http://eyes-free.googlecode.com/svn/trunk/TalkBack

  

 

======================== 代码看疯了++的分割线 =======================

 

看了最新的代码, 果断悲剧了: 里面没有StatusProvider! 看来不能靠TalkBack做事了.

尝试从开启TalkBack的地方入手, 发现 Settings -> 辅助功能 -> 服务 下面的 TalkBack 有一个开启状态描述. 所以: Settings是知道TalkBack的状态的.

 

找到切入点, 然后就是RTFSC!

 

根据Accessibility Service状态显示的切换, 定位到这个方法:

AccessibilitySettings.updateServicesPreferences();

 

这个方法, 会在AccessibilitySettings.updateAllPreferences()下调用, 而updateAllPreferences()则会在监听Settings数据库的ContentObserver下的onChange()里被调用.

这样逻辑就通了: 开启TalkBack -> 向Settings数据库写入服务开启状态(目前还不知道是谁写的这个值) -> ContentObserver.onChange()被触发 -> 更新TalkBack服务显示的enabled状态

 

以下是Settings这部分的代码分析:

AccessibilitySettings.updateServicesPreferences()里面有如下代码:

// 通过查找Settings数据库, 得到所有enabled状态的服务
Set<ComponentName> enabledServices = AccessibilityUtils.getEnabledServicesFromSettings(
                getActivity());
// 判断当前是否开启了辅助功能服务(一个全局开关, 具体在哪里配置与本文无关, 不表)
final boolean accessibilityEnabled = Settings.Secure.getInt(getContentResolver(), Settings.Secure.ACCESSIBILITY_ENABLED, 0) == 1;
...
for (...) {
    // 遍历所有已安装的服务, 判断是否已开启
    AccessibilityServiceInfo info = installedServices.get(i);
    ServiceInfo serviceInfo = info.getResolveInfo().serviceInfo;
    ComponentName componentName = new ComponentName(serviceInfo.packageName, serviceInfo.name);
    // 若辅助功能全局开关打开, 并且开启的服务中包含了已安装服务的话,
    // 判断该服务的状态为enable
    final boolean serviceEnabled = accessibilityEnabled && enabledServices.contains(componentName);
}

 

这里的serviceEnabled, 就是想要的服务启动状态值.

 

现在只需要读取TalkBack的开启状态, 因此, 在enabledServices中寻找, 看是否存在TalkBack即可.

接下来, 就是要知道这个enabledServices怎么来.

以下是AccessibilityUtils.getEnabledServicesFromSettings(Context)的关键代码:

final Set<ComponentName> enabledServices = new HashSet<ComponentName>();
// 从Settings数据库Secure表下, 检索Settings.Secure.ENABLED_ACCESSIBILITY_SERVICES对应的字符串
// 从下文可知, 这里的查询结果, 应该是所有服务ComponentName的一个字符串集合, 字符串间通过冒号分隔
final String enabledServicesSetting = Settings.Secure.getString(context.getContentResolver(), Settings.Secure.ENABLED_ACCESSIBILITY_SERVICES);
...
// 构造冒号Splitter, 按冒号切分上述查询结果
final SimpleStringSplitter colonSplitter = AccessibilitySettings.sStringColonSplitter;
colonSplitter.setString(enabledServicesSetting);
...
// 遍历切分出来的字符串(们), 得到enabled状态的服务
while (colonSplitter.hasNext()) {
    final String componentNameString = colonSplitter.next();
    final ComponentName enabledService = ComponentName.unflattenFromString(componentNameString);
    if (enabledService != null) {
        enabledServices.add(enabledService);
    }
}

 

======================== 代码看疯了++的分割线, 要吐了 =======================

 

按Settings的逻辑, 拟方案如下:

1. 监听Settings数据库的Secure表;

2. 当Settings.Secure.ENABLED_ACCESSIBILITY_SERVICES对应的值发生改变时, 读取之.

    判断其中是否包含TalkBack的开启状态;

3. 若包含, 则TalkBack服务开启, 否则未开启.