HXPhotoPicker图片双击缩放功能优化分析

问题背景

在HXPhotoPicker项目中，用户报告了一个关于图片查看器双击缩放功能的异常行为：当用户双击放大图片后，滑动到下一张图片再滑动回来时，图片会恢复初始大小。此时再次双击图片，图片会缩小而不是放大。此外，用户还提出了希望自定义双击缩放倍数的需求。

技术分析

当前实现机制

通过查看项目代码，发现当前实现中存在以下关键逻辑：

1. 双击放大功能通过监听手势识别器实现
2. 在滑动切换图片时，会对scrollView的zoomScale进行重置
3. 当前实现中只对视频内容的scrollView.zoomScale进行了恢复初始值处理

问题根源

问题的核心在于状态管理不完整。当用户滑动到其他图片再返回时，虽然视图的缩放比例被重置了，但内部记录的双击状态没有同步更新。这导致了以下行为链：

1. 用户双击图片A → 放大
2. 滑动到图片B → 视图重置
3. 滑动回图片A → 视图重置但内部状态仍记录为"已放大"
4. 再次双击 → 系统认为当前是"放大"状态，执行缩小操作

解决方案

针对这个问题，可以从以下几个方面进行优化：

1. 状态同步：在视图重置时，同时更新内部的双击状态记录
2. 缩放逻辑优化：重新设计双击缩放的状态机，使其更加健壮
3. 自定义缩放倍数：提供配置接口，允许开发者自定义双击缩放的比例

实现建议

状态管理改进

建议在resetScrollViewStatus方法中，不仅重置scrollView的zoomScale，还要重置相关的状态标志：

func resetScrollViewStatus() {
    scrollView.zoomScale = 1.0
    isZoomed = false  // 新增状态标志
    // 其他重置逻辑...
}

双击缩放逻辑重构

重构双击手势处理逻辑，使其基于当前实际的zoomScale而非内部状态：

@objc func doubleTapAction(_ doubleTap: UITapGestureRecognizer) {
    let zoomScale = scrollView.zoomScale
    let maxZoomScale = scrollView.maximumZoomScale
    let minZoomScale = scrollView.minimumZoomScale
    
    if zoomScale > minZoomScale {
        // 当前已放大，则缩小
        scrollView.setZoomScale(minZoomScale, animated: true)
    } else {
        // 当前未放大，则放大到预设比例
        let targetScale = customZoomScale ?? maxZoomScale / 2.0
        let point = doubleTap.location(in: doubleTap.view)
        let zoomRect = zoomRectForScale(targetScale, withCenter: point)
        scrollView.zoom(to: zoomRect, animated: true)
    }
}

自定义缩放倍数支持

为支持自定义缩放倍数，可以添加如下配置属性：

public struct PhotoBrowserConfig {
    /// 双击缩放比例，默认为最大缩放比例的一半
    public var doubleTapZoomScale: CGFloat?
    
    // 其他配置...
}

然后在双击处理逻辑中使用这个配置值：

let targetScale = config.doubleTapZoomScale ?? maxZoomScale / 2.0

用户体验考量

在实现这些改进时，还需要考虑以下用户体验因素：

1. 动画流畅性：缩放动画应该平滑自然，避免突兀的跳变
2. 视觉反馈：可以添加轻微的弹性效果，让用户感知到缩放操作
3. 性能优化：对于高分辨率图片，确保缩放操作不会导致卡顿
4. 边界处理：正确处理最小和最大缩放比例的边界情况

总结

通过对HXPhotoPicker图片查看器的双击缩放功能进行状态管理和逻辑重构，可以解决当前存在的异常行为问题。同时，通过添加配置接口支持自定义缩放倍数，能够为开发者提供更大的灵活性。这类改进不仅修复了功能缺陷，还增强了组件的可定制性，是开源项目持续优化的重要组成部分。