iOS Swift下VoiceOver启用时单指滑动手势检测方法咨询

Hey there! Great question—detecting VoiceOver swipe gestures in your iOS app is totally feasible, and it all revolves around Apple's UIAccessibility framework. Let me walk you through the two main approaches depending on your use case:

1. Global Detection (Listen for VoiceOver Swipes Across Your App) #

If you need to catch VoiceOver's left/right/up/down swipes anywhere in your app, you can register for the UIAccessibility.gestureNotification notification. This works on iOS 13 and above.

Here's how to implement it:

First, register the observer in your view controller (or app delegate):

override func viewDidLoad() {
    super.viewDidLoad()
    NotificationCenter.default.addObserver(
        self,
        selector: #selector(handleVoiceOverGesture(_:)),
        name: UIAccessibility.gestureNotification,
        object: nil
    )
}

Then, implement the handler method to react to each swipe type:

@objc private func handleVoiceOverGesture(_ notification: Notification) {
    guard let gestureType = notification.userInfo?[UIAccessibilityGestureNotificationGestureTypeKey] as? UIAccessibility.GestureType else {
        return
    }
    
    switch gestureType {
    case .swipeLeft:
        print("VoiceOver left swipe detected!")
        // Add your left-swipe logic here
    case .swipeRight:
        print("VoiceOver right swipe detected!")
        // Add your right-swipe logic here
    case .swipeUp:
        print("VoiceOver up swipe detected!")
        // Add your up-swipe logic here
    case .swipeDown:
        print("VoiceOver down swipe detected!")
        // Add your down-swipe logic here
    default:
        // Ignore other gesture types
        break
    }
}

Don't forget to clean up the observer when it's no longer needed:

deinit {
    NotificationCenter.default.removeObserver(
        self,
        name: UIAccessibility.gestureNotification,
        object: nil
    )
}

2. Custom UI Elements (Handle Swipes on Specific Views) #

If you want a custom view to respond directly to VoiceOver swipes, you'll work with the UIAccessibility protocol. Note that VoiceOver's default left/right swipes are used to navigate between accessibility elements, so you'll need different approaches for up/down vs left/right:

For Up/Down Swipes #

Use the accessibilityScroll(_:) method, which is part of the UIAccessibility protocol. This lets your view handle VoiceOver's up/down scroll gestures:

class CustomAccessibleView: UIView {
    // Mark the view as an accessibility element
    override var isAccessibilityElement: Bool {
        return true
    }
    
    override func accessibilityScroll(_ direction: UIAccessibilityScrollDirection) -> Bool {
        switch direction {
        case .up:
            print("VoiceOver up swipe handled by custom view!")
            // Add your up-swipe logic here
            return true // Return true to confirm you've handled the gesture
        case .down:
            print("VoiceOver down swipe handled by custom view!")
            // Add your down-swipe logic here
            return true
        default:
            return false // Return false if you don't handle the direction
        }
    }
}

For Left/Right Swipes #

Since left/right swipes are used for default navigation, you'll need to define custom VoiceOver gestures (iOS 14+). These let you add custom swipe actions that users can trigger on your view:

class CustomAccessibleView: UIView {
    override var isAccessibilityElement: Bool {
        return true
    }
    
    override var accessibilityCustomGestures: [UIAccessibilityCustomGesture]? {
        // Define a left-swipe custom gesture
        let leftSwipe = UIAccessibilityCustomGesture(name: "向左滑动") { [weak self] in
            self?.handleLeftSwipe()
            return true
        }
        
        // Define a right-swipe custom gesture
        let rightSwipe = UIAccessibilityCustomGesture(name: "向右滑动") { [weak self] in
            self?.handleRightSwipe()
            return true
        }
        
        return [leftSwipe, rightSwipe]
    }
    
    private func handleLeftSwipe() {
        print("Custom view handled VoiceOver left swipe!")
        // Add your left-swipe logic here
    }
    
    private func handleRightSwipe() {
        print("Custom view handled VoiceOver right swipe!")
        // Add your right-swipe logic here
    }
}

Users will need to set up these custom gestures in their VoiceOver settings (Settings > Accessibility > VoiceOver > Custom Gestures) to trigger them.

Key Notes #

• Make sure to test with VoiceOver enabled to verify your gestures work as expected.
• For global detection, be mindful that these gestures may interfere with VoiceOver's default navigation behavior, so use this sparingly.
• Custom gestures require iOS 14 or later, so add version checks if you support older OS versions.

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