如何判断UITableViewCell完全可见 实现视频自动播放及隐藏检测

原代码问题分析 #

你当前的判断逻辑存在两个核心问题导致结果不准确：

1. willDisplay代理的调用时机是cell即将被添加到视图前，此时cell的布局还未完全渲染到界面上，位置计算存在偏差
2. 仅在cell首次出现时做判断，覆盖不了滚动过程中cell从部分可见变为完全可见、或者完全滚出屏幕的场景，且未做坐标系的正确转换

正确实现步骤 #

• 步骤1：编写通用的cell完全可见判断方法，处理坐标系转换和tableView内边距适配

/// 判断UITableViewCell是否完全可见
func isCellFullyVisible(_ cell: UITableViewCell, in tableView: UITableView) -> Bool {
    // 将cell的frame转换为相对于tableView的坐标系
    let cellRect = cell.convert(cell.bounds, to: tableView)
    // 计算tableView当前的真实可见区域（兼容contentInset配置）
    let visibleRect = CGRect(
        x: tableView.contentOffset.x,
        y: tableView.contentOffset.y,
        width: tableView.bounds.width,
        height: tableView.bounds.height
    ).inset(by: tableView.contentInset)
    // 判断cell是否完全落在可见区域内
    return visibleRect.contains(cellRect)
}

• 步骤2：选择正确的触发时机，覆盖所有场景
  你需要在三个时机统一检测可见cell的状态：
  1. 页面完全展示（viewDidAppear）
  2. 拖动停止且无惯性滚动
  3. 惯性滚动完全结束
• 步骤3：实现状态处理逻辑

// 页面完全展示时触发首次判断
override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    handleVisibleCellsPlayState(in: tableView)
}

// 拖动结束且不会继续惯性滚动时触发
func scrollViewDidEndDragging(_ scrollView: UIScrollView, willDecelerate decelerate: Bool) {
    guard let tableView = scrollView as? UITableView, !decelerate else { return }
    handleVisibleCellsPlayState(in: tableView)
}

// 惯性滚动结束时触发
func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) {
    guard let tableView = scrollView as? UITableView else { return }
    handleVisibleCellsPlayState(in: tableView)
}

// 统一处理所有可见cell的视频播放状态
private func handleVisibleCellsPlayState(in tableView: UITableView) {
    for indexPath in tableView.indexPathsForVisibleRows ?? [] {
        guard let cell = tableView.cellForRow(at: indexPath) as? 你的自定义视频Cell类名 else { continue }
        let isFullyVisible = isCellFullyVisible(cell, in: tableView)
        if isFullyVisible {
            // 执行视频播放逻辑，注意避免重复初始化播放器
            cell.startPlay()
        } else {
            // 执行暂停/销毁播放器逻辑
            cell.stopPlay()
        }
    }
}

优化提示 #

• 如果你的业务场景允许cell高度大于tableView可见高度，可以将visibleRect.contains(cellRect)调整为判断cell可见面积占比超过指定阈值（比如70%）即可触发播放
• 可以添加最小可见时长防抖，避免快速滚动过程中频繁触发播放/暂停逻辑，提升性能
• 不要在tableView(_:cellForRowAt:)或者willDisplay中直接执行可见性判断，如需在该时机调用，需异步延迟到下一个runloop再执行，避免布局未完成导致的计算错误

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