Swift实现手指滑动视图读取单个组件 兼容VoiceOver方案咨询

该需求完全可以实现，核心思路是通过手势识别检测滑动过程中触碰的按钮，配合系统语音合成API实现朗读，同时做好VoiceOver运行状态判断避免功能冲突。

1. 基础配置准备 #

• 首先导入语音合成框架：import AVFoundation
• 全局声明语音合成器实例：let speechSynthesizer = AVSpeechSynthesizer()
• 给每个UIButton设置accessibilityLabel属性，值为需要朗读的内容，既可以给自定义朗读功能调用，也能直接兼容VoiceOver的默认朗读逻辑。

2. 滑动手势识别与触碰检测 #

给视图控制器的根视图添加Pan拖动手势识别器，滑动过程中实时检测触碰位置对应的按钮：

// 视图控制器内声明全局变量，存储上次触发朗读的按钮，避免重复朗读
var lastTouchedButton: UIButton?

override func viewDidLoad() {
    super.viewDidLoad()
    // 添加滑动手势
    let panGesture = UIPanGestureRecognizer(target: self, action: #selector(handlePanGesture(_:)))
    view.addGestureRecognizer(panGesture)
    // 配置所有按钮的朗读内容
    button1.accessibilityLabel = "按钮1对应朗读内容"
    button2.accessibilityLabel = "按钮2对应朗读内容"
    // 其余按钮同理配置即可
}

// 滑动手势响应方法
@objc func handlePanGesture(_ gesture: UIPanGestureRecognizer) {
    // 当前开启VoiceOver时直接返回，完全走系统原生交互逻辑，避免冲突
    guard !UIAccessibility.isVoiceOverRunning else { return }
    
    let touchLocation = gesture.location(in: view)
    // 遍历所有按钮判断是否被触碰
    for subview in view.subviews where subview is UIButton {
        guard let button = subview as? UIButton, 
              button.frame.contains(touchLocation),
              button != lastTouchedButton else { continue }
        // 触碰新按钮时更新记录，触发朗读
        lastTouchedButton = button
        speakContent(text: button.accessibilityLabel ?? "")
        return
    }
    // 滑动到非按钮区域时清空记录
    lastTouchedButton = nil
}

如果按钮嵌套在其他子视图内，遍历逻辑需要改为递归遍历所有层级的子视图，不要只遍历根视图的一级子视图。

3. 实现语音朗读方法 #

func speakContent(text: String) {
    // 停止上一次未完成的朗读，避免内容重叠
    if speechSynthesizer.isSpeaking {
        speechSynthesizer.stopSpeaking(at: .immediate)
    }
    let utterance = AVSpeechUtterance(string: text)
    // 可根据需求调整语速、发音语言等参数
    utterance.rate = 0.5
    utterance.voice = AVSpeechSynthesisVoice(language: "zh-CN")
    speechSynthesizer.speak(utterance)
}

4. VoiceOver兼容说明 #

• 上述代码已经通过UIAccessibility.isVoiceOverRunning判断，开启VoiceOver时会自动禁用自定义滑动朗读逻辑，完全使用系统原生的VoiceOver操作规则：用户通过VoiceOver默认的滑动手势选中按钮时，系统会自动朗读按钮的accessibilityLabel内容，无需额外适配。
• 如果需要自定义VoiceOver下的交互行为，可以进一步修改按钮的accessibilityTraits等属性，默认配置即可满足绝大多数场景需求。

• 可根据产品需求替换手势类型，比如改用UILongPressGestureRecognizer搭配位移检测，实现长按滑动选择按钮的交互逻辑，适配不同操作习惯。
• 可以给被选中的按钮添加高亮效果，提升视觉反馈。

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