Swift 5中如何追踪UICollectionView单元格可见时长并满足触发条件？

要实现「单元格至少50%可见且持续1秒时调用方法」的需求，核心是为每个单元格绑定独立的计时器，同时实时检测单元格的可见比例。以下是具体实现步骤：

1. 定义存储与配置变量 #

在你的ViewController中声明用于管理计时器的字典，以及可见阈值和时长参数：

private var cellTimers: [IndexPath: Timer] = [:]
private let requiredVisibilityThreshold: CGFloat = 0.5 // 50%可见要求
private let requiredDuration: TimeInterval = 1.0 // 持续1秒要求

2. 实现可见比例计算方法 #

用于判断当前单元格的可见区域占自身的比例：

private func visibilityRatio(for cell: UICollectionViewCell, in collectionView: UICollectionView) -> CGFloat {
    let cellFrame = collectionView.convert(cell.bounds, to: collectionView.superview)
    let visibleFrame = cellFrame.intersection(collectionView.bounds)
    // 横向CollectionView请将height改为width
    return visibleFrame.height / cellFrame.height
}

3. 核心计时器管理逻辑 #

通过checkAndManageTimer方法统一处理计时器的启动/停止，结合CollectionView的生命周期方法和滚动事件触发检测：

// 单元格即将显示时触发检测
func collectionView(_ collectionView: UICollectionView, willDisplay cell: UICollectionViewCell, forItemAt indexPath: IndexPath) {
    checkAndManageTimer(for: indexPath, in: collectionView)
}

// 单元格消失时停止对应计时器
func collectionView(_ collectionView: UICollectionView, didEndDisplaying cell: UICollectionViewCell, forItemAt indexPath: IndexPath) {
    stopTimer(for: indexPath)
}

// 滚动时实时检测所有可见单元格
func scrollViewDidScroll(_ scrollView: UIScrollView) {
    guard let collectionView = scrollView as? UICollectionView else { return }
    for visibleCell in collectionView.visibleCells {
        guard let indexPath = collectionView.indexPath(for: visibleCell) else { continue }
        checkAndManageTimer(for: indexPath, in: collectionView)
    }
}

// 检查并管理单个单元格的计时器状态
private func checkAndManageTimer(for indexPath: IndexPath, in collectionView: UICollectionView) {
    guard let cell = collectionView.cellForItem(at: indexPath) else {
        stopTimer(for: indexPath)
        return
    }
    
    let ratio = visibilityRatio(for: cell, in: collectionView)
    
    if ratio >= requiredVisibilityThreshold {
        // 可见比例达标，且无计时器时创建新计时器
        if cellTimers[indexPath] == nil {
            let timer = Timer.scheduledTimer(withTimeInterval: requiredDuration, repeats: false) { [weak self] _ in
                self?.targetMethod(for: indexPath)
                self?.stopTimer(for: indexPath) // 触发方法后停止计时器
            }
            cellTimers[indexPath] = timer
        }
    } else {
        // 可见比例不足，停止对应计时器
        stopTimer(for: indexPath)
    }
}

// 停止并移除指定单元格的计时器
private func stopTimer(for indexPath: IndexPath) {
    cellTimers[indexPath]?.invalidate()
    cellTimers.removeValue(forKey: indexPath)
}

// 满足条件时调用的目标方法
private func targetMethod(for indexPath: IndexPath) {
    print("单元格 \(indexPath.item) 满足可见要求，执行目标逻辑")
    // 这里替换为你的业务代码
}

关键说明 #

• 用[IndexPath: Timer]字典存储每个单元格的计时器，确保每个单元格的计时状态独立，不会互相干扰。
• 实时检测滚动事件，避免单元格滚动过程中可见比例变化导致的误触发。
• 使用weak self避免计时器与ViewController之间的循环引用。
• 若为横向布局的CollectionView，只需将visibilityRatio方法中的height替换为width即可适配。

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