滚动控制视频进度问题：超最大偏移后回滚进度无响应

问题场景 #

开发滚动控制视频进度功能：向下滚动时，将Y偏移量映射为0-1的进度值，视频跳转至对应位置；向上滚动时偏移量减小，进度降低，视频倒放。现有核心方法如下：

private var initialVisibleOffset: CGFloat?
private var previousScrollOffset: CGFloat = 0.0

func mapScrollOffsetToProgression(_ offset: CGFloat) -> Double {
    guard let initialOffset = initialVisibleOffset else {
        initialVisibleOffset = offset
        return 0.0
    }

    let maxOffset: CGFloat = 500
    let filteredOffset = lowPassFilter(newValue: offset - initialOffset, oldValue: previousScrollOffset, alpha: 0.1)
    var progress = -Double(filteredOffset / maxOffset)

    previousScrollOffset = filteredOffset

    return min(max(progress, 0.0), 1.0)
}

功能整体正常，但存在问题：当向下滚动偏移量超过maxOffset后，进度被固定在1.0；此时向上滚动，必须滚回大量偏移量，直到绝对偏移量回到maxOffset范围内，进度才会开始下降，导致回滚初期视频静止。需求是：只要视频可见，用户开始向上滚动时，进度立即降低，不受当前偏移量大小影响。

问题根源 #

原实现依赖绝对滚动偏移量与maxOffset的比值计算进度，当偏移量超出maxOffset后，进度被范围限制函数钉死在1.0。向上滚动时，必须先抵消超出的偏移量，进度才会变化，导致回滚初期无响应。

修复方案 #

改用滚动偏移变化量来更新进度，同时跟踪当前有效进度值，确保滚动操作即时生效：

private var initialVisibleOffset: CGFloat?
private var previousScrollOffset: CGFloat = 0.0
private var currentClampedProgress: Double = 0.0 // 跟踪当前有效进度

func mapScrollOffsetToProgression(_ offset: CGFloat) -> Double {
    guard let initialOffset = initialVisibleOffset else {
        initialVisibleOffset = offset
        currentClampedProgress = 0.0
        return 0.0
    }

    let maxOffset: CGFloat = 500
    let rawOffsetDelta = offset - initialOffset
    let filteredOffset = lowPassFilter(newValue: rawOffsetDelta, oldValue: previousScrollOffset, alpha: 0.1)
    
    // 计算本次滚动的偏移变化量
    let offsetDelta = filteredOffset - previousScrollOffset
    // 转换为进度变化量
    let progressDelta = -Double(offsetDelta / maxOffset)
    
    // 更新当前进度并限制在0-1区间
    currentClampedProgress = min(max(currentClampedProgress + progressDelta, 0.0), 1.0)
    
    previousScrollOffset = filteredOffset
    return currentClampedProgress
}

关键改动说明 #

• 新增currentClampedProgress变量，专门存储当前视频的有效进度，避免每次依赖绝对偏移量重新计算
• 计算滚动的偏移变化量（而非绝对偏移量），将其转换为进度变化量，确保只要用户滚动，进度立刻响应
• 通过min(max(...))限制进度在0-1范围内，既保留了进度的边界约束，又解决了回滚初期无响应的问题

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