前言

方案实现

原始需求

隐藏需求

方案制定

具体实现

总结

附录

前言

互联网内容已经逐渐从图文阅读往如今火热的短视频更迭，某种程度上短视频有着图文所没有的优势和不可替代性，降低了自我表达的门槛。近期迭代做了个短视频列表滚动自动播放的需求，上线了一段时间。觉得略有趣，简单分享下方案。

本文提供了 Demo ，将方案进行简化处理，只包含核心的功能实现。

本文的 Demo 附在文末

方案实现

介绍下整个方案的思考和实现的一些过程。

原始需求

简化如下：

自动播放条件

Wifi环境下，当视频中心位置从下往上越过屏幕的2/3位置，或从上往下越过屏幕的1/3位置时，视频开始自动播放；

停止播放条件

当视频中心位置离开可见区域时，视频自动停止播放。若下一个视频满足开始自动播放的条件，则上一个视频自动停止播放。

手动播放

点播放按钮可手动开始播放。开始播放某视频后，其他视频停止播放。

隐藏需求

原始需求背后需要考虑的其他情况：

页面进入/离开的处理

App进入后台/返回前台的处理

从一个视频列表跳转到另一个视频列表的处理

页面包含安全区的处理

列表滚动播放的性能问题

视频循环播放/静音功能

上拉加载更多/下拉刷新等动作触发的滚动的处理

列表 cell 的复用问题

方案制定

主要考虑了以下一些方面：

优先考虑的是性能问题，同一个列表中尽量只有一个视频控件

尽量降低方案的侵入性，目前有多个现有列表需要支持该功能，涉及到多个 controller 和多个 cell ，侵入性低也利于改动和维护

隐藏需求会影响到自动播放逻辑的调用时机

大致思路如下：

由一个类管理整个 App 的视频滚动播放的相关逻辑，包括视频组件。

由 controller 监控滚动，触发管理类进行处理。管理类计算当前符合自动播放的视频，播放并将视频组件嵌入 cell 中。

为了降低侵入性，采用协议实现管理类和 controller、管理类和 cell 间的通信。也利于改动逻辑时只改动到管理类，而不是牵涉各个调用处和 cell。

隐藏需求处理：

页面进入/离开的处理、从一个视频列表跳转到另一个视频列表的处理

在 controller 的生命周期中去调用管理类方法进行处理。离开时停止当前播放中的视频，进入时播放当前列表的视频。进入时判断数据源是否已经获取，已经获取则调用播放。另外在数据源获取后判断是否已经 Appear，是则调用播放。用变量标志避免两个逻辑重复调用。

App进入后台/返回前台的处理

App 进入后台/返回前台不会调用 controller 的生命周期，需要另外处理。

页面包含安全区的处理

在计算视频的相对位置时，将安全区考虑在内进行计算。

列表滚动播放的性能问题

测试 列表滚动停止时 、 实时滚动时 、 滚动降速到一定速度时 等情况下，调用自动播放逻辑的性能和体验，

视频循环播放/静音功能

视频播放完毕的事件需要通过监听 NSNotification.Name.AVPlayerItemDidPlayToEndTime 实现，放在管理类中进行处理。

上拉加载更多/下拉刷新等动作触发的滚动的处理

在这两种情况下，需要停止页面的逻辑调用，直到数据源返回成功或失败为止。

列表 cell 的复用问题

复用时需要重新布置frame、清空数据源等。

具体实现

定义管理类 VideoListAutoPlayManager

class VideoListAutoPlayManager {

private init() {

playerVC.player = AVPlayer()

playerVC.showsPlaybackControls = false

playerVC.view.backgroundColor = UIColor.clear

}

static let shared = VideoListAutoPlayManager()

private var playerVC: AVPlayerViewController = AVPlayerViewController()

private var preOffsetY: CGFloat = 0

private var currentPlayingView: VideoPlayable?

}

需要保存一些信息和状态，所以定义成单例。

AVPlayerViewController 自带控制条，需要隐藏。

视频播放时背景从黑色开始，会导致出现先看到封面，然后黑色，然后再播放视频的问题，设置为透明会让从封面到视频的过渡自然。

preOffsetY 记录当前滚动的 UIScrollView 的 contentOffset.y 。用于在多个视频满足自动播放时，通过判断滚动方向来决定选取哪个视频自动播放。

currentPlayingView 记录当前播放中的 cell。用于通知上一个播放的 cell 即将停止播放视频，方便 cell 处理另外的逻辑。

定义协议

protocol VideoPlayable: UIView {

var viewToContainVideo: UIView {get}

var urlToPlay: URL? {get}

func videoStatusChanged(changeTo isPlaying: Bool)

}

protocol VideoListPlayable: UIScrollView {

var visibleViews: [VideoPlayable] {get}

}

extension UITableView: VideoListPlayable {

var visibleViews: [VideoPlayable] {

let views: [VideoPlayable] = visibleCells.compactMap({ $0 as? VideoPlayable })

return views

}

}

extension UICollectionView: VideoListPlayable {

var visibleViews: [VideoPlayable] {

let views: [VideoPlayable] = visibleCells.compactMap({ $0 as? VideoPlayable })

return views

}

}

第一个协议，VideoPlayable，是存放视频的 cell 需要实现的。实现协议返回需要包含视频的 view ，需要播放的视频 URL，以及用于 VideoListAutoPlayManager 通知 cell 处理视频播放状态变化的调用方法。

第二个协议，VideoListPlayable，是滚动列表需要实现的。实现协议返回滚动列表当前可见的 cell，用于 VideoListPlayable 去判断哪些视频需要自动播放。

两个协议都遵循某个类，UIView 或 UIScrollView，是有些取巧，方便后面取 frame 等。也可以不遵循，然后在协议中返回需要的数据即可。

另外为 UITableView 和 UICollectionView 做了默认实现。

触发滚动播放的处理

func scrollViewDidScroll(_ scrollView: VideoListPlayable) {

let currentOffsetY = scrollView.contentOffset.y

let minY = scrollView.frame.height / 3

let maxY = minY * 2

// 获取在 scrollView 自动播放区域内的视频

let autoPlayableViews = scrollView.visibleViews.filter { view in

guard let relativeRect = relativeRect(view: view.viewToContainVideo, relativeTo: scrollView), view.urlToPlay != nil else {return false}

let containerCenterY = relativeRect.minY + relativeRect.height / 2

return (containerCenterY > minY && containerCenterY < maxY)

}

guard let first = autoPlayableViews.first else {

// 没有需要自动播放的视频

// 移除当前正在离开/已经离开屏幕的视频

removeCurrentVideoIfLeavingScreen(scrollView: scrollView)

preOffsetY = currentOffsetY

return

}

// 取出需要自动播放的视频

let viewToPlay: VideoPlayable = autoPlayableViews.reduce(first) { (result, view) in

let isScrollToUpper = currentOffsetY view.frame.maxY ? (isScrollToUpper ? view : result) : (isScrollToUpper ? result : view)

}

if let currentPlayingView = currentPlayingView, viewToPlay as UIView == currentPlayingView {

// 满足条件的视频正在播放中

preOffsetY = currentOffsetY

return

}

removeCurrentVideo(on: scrollView)

addPlayerView(to: viewToPlay, on: scrollView)

preOffsetY = currentOffsetY

}

VideoListAutoPlayManager 提供该方法用于 controller 需要进行视频自动播放处理时进行调用。

外部可以自行决定在什么时机，进行视频自动播放逻辑的触发，不需要是在 scrollViewDidScroll 的时机。

该方法主要逻辑是：

取出当前可见区域中，满足自动播放条件(func relativeRect(view: UIView, relativeTo scrollView: VideoListPlayable) -> CGRect?)的 cell，即相对位置为滚动列表的 1/3 至 2/3 的位置。

如果没有满足条件的，则判断当前是否有播放中的视频，且视频即将或已经离开屏幕，有则停止播放视频，并通知 cell。

如果有满足条件的视频，则根据滚动方向选取视频(列表向上滚动时，播放靠下的视频，反之则播放靠上的视频)，移除上一个播放中的视频(通知对应的 cell)，切换视频源并播放，通知最新播放的 cell。

手动播放的处理

func play(at videoView: VideoPlayable, on scrollView: VideoListPlayable) {

removeCurrentVideo(on: scrollView)

addPlayerView(to: videoView, on: scrollView)

}

即移除当前播放中的视频，并将当前手动指定播放的视频进行播放。

添加视频组件

func addPlayerView(to view: VideoPlayable, on scrollView: VideoListPlayable) {

guard let url = view.urlToPlay else {

return

}

let avItem = AVPlayerItem(url: url)

let avPlayer = AVPlayer(playerItem: avItem)

playerVC.player = avPlayer

avPlayer.isMuted = true

avPlayer.play()

view.videoStatusChanged(changeTo: true)

let containerView = view.viewToContainVideo

containerView.addSubview(playerVC.view)

playerVC.view.translatesAutoresizingMaskIntoConstraints = false

playerVC.view.topAnchor.constraint(equalTo: containerView.topAnchor).isActive = true

playerVC.view.bottomAnchor.constraint(equalTo: containerView.bottomAnchor).isActive = true

playerVC.view.leftAnchor.constraint(equalTo: containerView.leftAnchor).isActive = true

playerVC.view.rightAnchor.constraint(equalTo: containerView.rightAnchor).isActive = true

currentPlayingView = view

}

通过协议获取包含视频的 view，将视频放入其中，通知 cell 进行状态变化处理。

隐藏需求的实现

基本按照上一个部分讲的思路实现，没有将这部分代码放到 Demo 中。

总结

目前的方案，cell只需实现协议，添加一个用于包含视频的 view 即可。这样降低了对原代码的侵入性、减少修改和维护的成本，可随时去除该自动播放的特性。另外隐藏需求实际花费的思考和时间会比原始需求多些，需要考虑很多细节。