iOS WebView启用Voice Control后上下滚动功能失效问题

问题背景 #

• 操作路径：辅助功能设置 > 语音控制 > 开启/关闭语音控制
• 问题现象：启用Voice Control后，无法通过「向上滚动/向下滚动」语音指令控制WebView内容滚动
• 实际结果：语音控制无法对WebView页面执行上下滚动操作
• 预期结果：语音指令可正常控制WebView页面滚动

解决方案 #

1. 配置WebView的可访问性属性 #

系统语音控制依赖控件的可访问性标识识别交互能力，需将WebView标记为可滚动容器：

iOS 代码示例

webView.accessibilityTraits.insert(.scrollable)
webView.isAccessibilityElement = true

Android 代码示例

webView.apply {
    isFocusable = true
    isFocusableInTouchMode = true
    accessibilityDelegate = object : View.AccessibilityDelegate() {
        override fun onInitializeAccessibilityNodeInfo(host: View?, info: AccessibilityNodeInfo?) {
            super.onInitializeAccessibilityNodeInfo(host, info)
            info?.apply {
                addAction(AccessibilityNodeInfo.ACTION_SCROLL_FORWARD)
                addAction(AccessibilityNodeInfo.ACTION_SCROLL_BACKWARD)
            }
        }
    }
}

2. 重置语音控制功能 #

部分场景下语音控制的缓存状态会导致识别异常，可按以下步骤重置：

• 进入「辅助功能设置 > 语音控制」关闭功能
• 等待10秒后重新开启语音控制
• 再次测试滚动指令

3. 排查WebView自身滚动问题 #

若手动操作也无法滚动WebView，需先修复基础滚动能力：

• 检查是否设置了scrollEnabled = false（iOS）或setScrollContainer(false)（Android）
• 确认网页内容高度超过WebView可视区域，存在可滚动空间
• 验证WebView未被父控件拦截滚动事件

4. 系统版本兼容性检查 #

部分旧版本iOS/Android存在WebView与语音控制的兼容性bug，可尝试：

• 更新系统到最新稳定版本
• 升级WebView组件（Android可在应用商店更新Chrome WebView）

内容的提问来源于stack exchange，提问作者Niladri