山川湖海 - Android无障碍代理的那些事

简介: 本篇将聊一聊什么是无障碍代理,及结合实际场景,分享一下我们对于无障碍代理的使用,并且如何让其更加易用。

什么是无障碍代理?

当用户在无障碍模式下时,用户在界面上与View的所有操作,都会触发相应的无障碍事件,这些事件最终由 无障碍服务处理 ,其会利用这些事件中的信息生成反馈和提示。自Android1.6(Api-4)开始,Android提供了相应的无障碍事件的代理扩展,我们可以通过实现相应的无障碍代理类(AccessibilityDelegateAccessibilityDelegateCompat),从而监听相应的方法回调,完成一些配置或者参数的更改,以便满足某些场景下的更改。

它可以做什么?

  • 响应无障碍事件,完善自定义的无障碍提示,以及做出一些更改
  • 捕获在用户无障碍下的行为信息,比如做数据统计或分析

前者这也是无障碍代理诞生的主因,而后者是我们近期在排查时,发现某个厂商sdk其内部的一个操作,也是有点惊讶。

API详解

AccessibilityDelegate

具体Api解释如下,以下内容来源于 Android文档

Api4

  • sendAccessibilityEvent()
    当用户对视图执行操作时调用此方法。事件根据用户操作类型进行分类,如 TYPE_VIEW_CLICKED。除非您要创建自定义视图,否则通常无需实现此方法。
  • sendAccessibilityEventUnchecked()

如果发起调用的代码需要直接控制对设备上是否启用无障碍功能 (AccessibilityManager.isEnabled()) 进行检查,则使用此方法。如果您实现此方法,则无论实际的系统设置如何,您都必须像已启用无障碍功能那样执行调用。您通常不需要为自定义视图实现此方法。

  • dispatchPopulateAccessibilityEvent()

系统会在您的自定义视图生成无障碍事件时调用此方法。从 API 级别 14 开始,此方法的默认实现会为此视图调用 onPopulateAccessibilityEvent(),然后为此视图的每个子级调用 dispatchPopulateAccessibilityEvent() 方法。为了在早于 4.0(API 级别 14)的 Android 修订版上支持无障碍服务,您必须替换此方法并使用自定义视图的描述性文字填充 getText(),这些文字会由 TalkBack 等无障碍服务读出。

Api14

  • onPopulateAccessibilityEvent()
    此方法为您的视图设置 AccessibilityEvent 的文字转语音提示。如果该视图是生成无障碍事件的视图的子级,则也调用此方法。

注意:修改此方法中除文字之外的其他属性可能会替换其他方法设置的属性。虽然您可以使用此方法修改无障碍事件的属性,但应将这些更改限制为文字内容,并使用 onInitializeAccessibilityEvent() 方法修改事件的其他属性。

注意:如果此事件的实现会完全替换输出文字且不允许布局的其他部分修改其内容,则请勿在您的代码中调用此方法的超类实现。

onInitializeAccessibilityEvent()

除了文字内容之外,系统还会调用此方法来获取有关视图状态的其他信息。如果您的自定义视图提供除了简单的 TextView 或 Button 之外的其他互动控件,则您应替换此方法并将有关视图的其他信息设置到使用此方法的事件中,如密码字段类型、复选框类型或者提供用户互动或反馈的状态。如果您替换此方法,则必须调用其超类实现,然后只修改超类未设置的属性。

onInitializeAccessibilityNodeInfo()

此方法为无障碍服务提供有关视图状态的信息。默认的 View 实现具有一组标准的视图属性,但如果您的自定义视图提供除了简单的 TextView 或 Button 之外的其他互动控件,则您应替换此方法并将有关视图的其他信息设置到由此方法处理的 AccessibilityNodeInfo 对象中。

onRequestSendAccessibilityEvent()

系统会在您的视图的子级生成 AccessibilityEvent 时调用此方法。通过此步骤,父视图可以使用其他信息修改无障碍事件。仅当您的自定义视图具有子视图且父视图可以向无障碍事件提供有助于无障碍服务的上下文信息时,才应实现此方法。

需要注意的是,如果我们的Api版本>=14,即Android4.0及以上,则可以直接在View中实现上述方法,

否则使用 ViewCompat.setAccessibilityDelegate() 或者 View.setAccessibilityDelegate() 设置相应的代理,从而重写相应的方法。

注意事项

无障碍代理有两种设置方式,默认的与兼容版本,即 AccessibilityDelegateAccessibilityDelegateCompat

加compat的一般都为前者的兼容版本,以满足低版本的一些功能兼容,但我还是 强烈 建议大家使用后者。

具体原因是:

使用 AccessibilityDelegate 作为代理类时,当我们将 view.accessibilityDelegate=null 时,即我们解绑代理时,我们认为这个代理之后不会被调用,实则它依然会每次被调用,比较离谱。

而当你使用 AccessibilityDelegateCompat 时,你会发现当你调用 ViewCompat.setAccessibilityDelegate(view, null) 时,你之前的代理类就不会被调用,是不是很离谱,而观察源码你会发现,当使用 ViewCompat设置为 null 时,内部不是直接赋值,而是给予了一个新的实例。

让无障碍代理更易用

作为我们目前的业务,无障碍代理更多的场景是,为某个 [没有状态]View 增加选中状态,于是我们能很轻松的写出以下代码:

val delegateCompat = object : AccessibilityDelegateCompat() {
    override fun onInitializeAccessibilityNodeInfo(
        host: View?,
        info: AccessibilityNodeInfoCompat?
    ) {
        super.onInitializeAccessibilityNodeInfo(host, info)
        // 你的自定义逻辑
        info?.isChecked = xxx 
        info?.isCheckable = true
    }
}
ViewCompat.setAccessibilityDelegate(this, delegateCompat)

最简单的优化,我们自然可以把它提取出来,以便后续复用,于是就有了如下的代码:

优化1 ->

inline fun lazyAcesDeleteSelectSimple(crossinline obj: () -> Boolean): Lazy<AccessibilityDelegateCompat> =
    lazy {
        object : AccessibilityDelegateCompat() {
            override fun onInitializeAccessibilityNodeInfo(
                host: View?,
                info: AccessibilityNodeInfoCompat?
            ) {
                super.onInitializeAccessibilityNodeInfo(host, info)
                info?.isChecked = obj.invoke()
                info?.isCheckable = true
            }
        }
    }
//使用处
val xxxViewAcesDelegate by lazyAcesDeleteSelectSimple{
  //你的逻辑
   true or false
}
val view=View(null)
ViewCompat.setAccessibilityDelegate(view, xxxViewAcesDelegate)

这段代码也很好理解,我们借助 Lazy 委托,在后续使用时再初始化这个代理,并将方法进行了抽取。

优化2 ->

前段时间同事在review代码时提到,你的无障碍这块能不能再简化一点?作为我们的业务场景,大多数情况下,增加代理 只是为了给View或者ImageView增加一个选中状态,我看你现在的写法是写了一个统一的调用方法和回调,其实已经挺好。那能不能更简化一点,比如我们未来其他的配置或者更改等等。

比如 View 自身的也有 isSelected 属性,你看看能不能做到只更改这个属性,就可以自动的适配无障碍下的选中状态。对于外部调用者而言,我无需去关心无障碍也能轻松适配。比如大家都知道 contenDescortrion 属性,但不一定人人都知道需要 传递委托代理 ,复杂情况下还得重写相应方法,不够便捷。

听完之后,然后做了如下改良,思路如下:

  • 增加无障碍接口,里面是一些 [简化] 的配置操作
  • 继承自 AccessibilityNodeInfoCompat 并增加相应的回调函数,并实现上述无障碍接口
  • 增加 View 的扩展属性,比如 View.accessDelegate , View.isAccessSelected ,前者返回无障碍接口,后者用于控制此 view 是否已选中。

示例代码如下:

增加代理接口:

interface IAccessibilityDelegate {
    /** 无障碍下是否选中
     *
     * 默认会使用此字段来控制,如果实现了[setSelectedProvider],则此字段仅作为状态查看 */
    var isSelect: Boolean
    /** 使用回调的方式设置无障碍选中状态,某些业务场景下会用到,优先使用[isSelect]即可
     *
     * 注意:如果此方法被启用,则优先使用此回调,此时[isSelect]仅作为状态查看 */
    fun setSelectedProvider(obj: (() -> Boolean)?): IAccessibilityDelegate
    /** 此方法为无障碍服务提供有关视图状态的信息,增加此监听便于外部监听 */
    fun setInitializeNodeInfoListener(obj: (View, AccessibilityNodeInfoCompat) -> Unit): IAccessibilityDelegate
    /** 解绑所有回调 */
    fun unBind()
}

增加代理实现类:

class CustomAccessibilityDelegateCompat : AccessibilityDelegateCompat(), IAccessibilityDelegate {
    override var isSelect: Boolean = false
    /**
     * 内部重写的一些方法,暂时只用到了这些,如果有其他的,可以加到下面,并更改[IAccessibilityDelegate]
     * -> */
    private var onSelectedProvider: (() -> Boolean)? = null
    private var onInitializeAccessibilityNodeInfo: ((View, AccessibilityNodeInfoCompat) -> Unit)? = null
    /** 此方法为无障碍服务提供有关视图状态的信息。 */
    override fun onInitializeAccessibilityNodeInfo(
        host: View?,
        info: AccessibilityNodeInfoCompat?
    ) {
        super.onInitializeAccessibilityNodeInfo(host, info)
        if (host == null || info == null) return
        onInitializeAccessibilityNodeInfo?.invoke(host, info)
        isSelect = onSelectedProvider?.invoke() ?: (isSelect || host.isSelected)
        info.isChecked = isSelect
        info.isCheckable = true
    }
    override fun setSelectedProvider(obj: (() -> Boolean)?): IAccessibilityDelegate {
        onSelectedProvider = obj
        return this
    }
    override fun setInitializeNodeInfoListener(obj: (View, AccessibilityNodeInfoCompat) -> Unit): IAccessibilityDelegate {
        onInitializeAccessibilityNodeInfo = obj
        return this
    }
    override fun unBind() {
        onInitializeAccessibilityNodeInfo = null
    }
}

增加kt扩展类

@file:JvmName("AccessibilityUtils")
private const val ACCESS_DEFAULT_CONTENT_DESCRIPTION = "ACCESS_DEFAULT_CONTENT_DESCRIPTION"
/**
 * 设置当前View在无障碍下是否已选中
 * 使用view默认的isSelect也同样受用,前提是已经调用过[initXcfAccessDelegate]
 * */
var View.isAccessSelected: Boolean
    get() = accessDelegate.isSelect || isSelected
    set(value) {
        accessDelegate.isSelect = value
    }
/** 获取自定义的无障碍接口 */
val View.accessDelegate: IAccessibilityDelegate
    get() {
        val delegate = ViewCompat.getAccessibilityDelegate(this) as? IAccessibilityDelegate
        if (delegate == null) {
            val newDelegate = CustomAccessibilityDelegateCompat()
            ViewCompat.setAccessibilityDelegate(this, newDelegate)
            return newDelegate
        }
        return delegate
    }
/** 初始化无障碍委托,满足一些基础view的免操作适配 */
@JvmOverloads
fun View.initAccessDelegate(contentDescription: String = ACCESS_DEFAULT_CONTENT_DESCRIPTION):
    IAccessibilityDelegate {
    if (contentDescription != ACCESS_DEFAULT_CONTENT_DESCRIPTION)
        this.contentDescription = contentDescription
    return AccessDelegate
}

使用方式:

// 例如有一个使用ImageView做开关的 [历史代码]
fun test() {
    val toggleView = ImageView(context)
    // 通过扩展属性设置
    toggleView.isAccessSelected = false
    // 通过自定的逻辑去设置
    toggleView.initXcfAccessDelegate("xx开关").setSelectedProvider(::checkToggle)
}
/** 你的业务逻辑 */
fun checkToggle(): Boolean = false

经过上述这样的步骤,我们就可以较为轻松的为任意 View 增加选中状态,同时对于其他同学而言,成本也比较低。

上述如果要增加新的api,也可以更改相应的代理类,同时在接口中定义新的 setXXXListener 即可。

总结

通过无障碍事件的重写,极大程度上减轻了我们在 View 上的适配成本,对于无法直接重写相应方法的,我们也可以间接通过无障碍代理去完成,相对来讲成本并不高,再加上我们对其进行相应的封装后,使用难度就更加容易。

目录
相关文章
|
5月前
|
网络协议 Android开发 数据安全/隐私保护
Android手机上使用Socks5全局代理-教程+软件
Android手机上使用Socks5全局代理-教程+软件
4572 2
|
4月前
|
XML 自然语言处理 Android开发
🌐Android国际化与本地化全攻略!让你的App走遍全球无障碍!🌍
【7月更文挑战第28天】在全球化背景下,实现Android应用的国际化与本地化至关重要 for 用户基础扩展。本文通过旅游指南App案例,介绍全攻略。步骤包括资源文件拆分与命名、适配布局与方向、处理日期时间及货币格式、考虑文化习俗及进行详尽测试。采用Android Studio支持,创建如`res/values-en/strings.xml`等多语言资源文件夹,使用灵活布局解决文本长度差异问题,并通过用户反馈迭代优化。最终,打造一款能无缝融入全球各地文化的App。
190 3
|
2月前
|
XML Android开发 数据格式
🌐Android国际化与本地化全攻略!让你的App走遍全球无障碍!🌍
在全球化背景下,实现Android应用的国际化与本地化至关重要。本文以一款旅游指南App为例,详细介绍如何通过资源文件拆分与命名、适配布局与方向、处理日期时间及货币格式、考虑文化习俗等步骤,完成多语言支持和本地化调整。通过邀请用户测试并收集反馈,确保应用能无缝融入不同市场,提升用户体验与满意度。
96 3
|
Android开发
Android Studio使用本地代理
Android Studio使用本地代理
903 0
|
XML 编译器 Android开发
山川湖海 - Android无障碍功能优化实践
本文主要分享Android无障碍功能的一些优化经验,希望看完本篇,可以帮助到你,以及哪些特殊的用户。
393 0
山川湖海 - Android无障碍功能优化实践
|
Android开发 Windows
mac下,依赖于Charles代理,wireshark抓取Android设备报文
mac下,依赖于Charles代理,wireshark抓取Android设备报文
|
Android开发
Android面试题:bindService获取代理是同步还是异步
Android面试题:bindService获取代理是同步还是异步
541 0
Android面试题:bindService获取代理是同步还是异步
|
人工智能 算法 Android开发
Android自动化中动态设置网络代理
由于现在很多应用的页面数据都是AI算法推荐生成的,所以每次打开同一个页面数据都会不一样,因此在做客户端UI自动化的过程中都会采用Mock方案,利用MockServer来提供稳定的测试数据,其中MockServer的代理需要手动配置。 拿Android手机举例,过程大致是:进入设置->进入 WLAN ->找对应 wifi 连接->进入详情->找到代理->选择手动->输入主机名->输入端口号->最后保存,可以看到每次都是重复操作,特别当你的自动化设备很多以及MockServer服务不稳定导致IP经常变的情况下累加的时间成本是很高的,而且一不小心,还有可能写错
444 0
Android自动化中动态设置网络代理
|
Java Android开发 开发者
【Android 插件化】Hook 插件化框架 ( Hook 技术 | 代理模式 | 静态代理 | 动态代理 )(一)
【Android 插件化】Hook 插件化框架 ( Hook 技术 | 代理模式 | 静态代理 | 动态代理 )(一)
140 0