iPad上的AVPlayer是iOS开发中用于播放媒体文件的核心组件，它提供了强大的音视频播放功能，支持本地文件、网络流媒体等多种来源，本文将详细介绍AVPlayer的基本使用方法、常见功能实现及注意事项,帮助开发者快速上手。
AVPlayer基础概念
AVPlayer属于AVFoundation框架，与UIKit中的AVPlayerView不同，AVPlayer本身不提供UI界面，专注于媒体播放逻辑，使用时需结合AVPlayerLayer将视频渲染到视图上，或通过AVPlayerItem管理播放状态,其核心类包括：
- AVPlayer：播放器控制器，负责播放控制
- AVPlayerItem：媒体项，封装媒体资源与播放状态
- AVPlayerLayer：视频图层，用于显示视频内容
- AVAsset：媒体资源，支持本地文件、网络URL等
基本播放流程
创建播放器
首先导入AVFoundation框架,通过URL初始化AVPlayer：
import AVFoundation let videoURL = URL(string: "https://example.com/video.mp4")! let player = AVPlayer(url: videoURL)
关联视图
将播放器与AVPlayerLayer绑定,并添加到视图层级：
let playerLayer = AVPlayerLayer(player: player) playerLayer.frame = view.bounds view.layer.addSublayer(playerLayer)
播放控制
通过player对象控制播放：
player.play() // 播放 player.pause() // 暂停 player.rate = 2.0 // 设置播放速率（2倍速）
高级功能实现
播放状态监控
通过KVO观察AVPlayerItem的status属性,监听加载状态：
let playerItem = player.currentItem
playerItem?.observe(\.status, changeHandler: { item, _ in
if item.status == .readyToPlay {
print("视频准备就绪")
} else if item.status == .failed {
print("加载失败: \(item.error?.localizedDescription ?? "")")
}
})
播放进度监控
使用addPeriodicTimeObserver获取播放进度：
let time = CMTime(seconds: 1.0, preferredTimescale: CMTimeScale(NSEC_PER_SEC))
player.addPeriodicTimeObserver(forInterval: time, queue: .main) { time in
let currentTime = CMTimeGetSeconds(time)
print("当前进度: \(currentTime)")
}
音视频控制
音量控制：
player.volume = 0.5 // 0.0~1.0
静音控制：
player.isMuted = true
播放模式：
player.actionAtItemEnd = .pause // 播放结束后暂停（默认为.advance）
本地文件播放
对于本地文件,需先转换为AVAsset：
let localURL = Bundle.main.url(forResource: "video", withExtension: "mp4")! let asset = AVAsset(url: localURL) let playerItem = AVPlayerItem(asset: asset) player.replaceCurrentItem(with: playerItem)
常见问题处理
横屏适配
通过AVPlayerLayer的videoGravity设置视频填充模式：
playerLayer.videoGravity = .resizeAspect // 保持比例，可能留黑边 playerLayer.videoGravity = .resizeAspectFill // 保持比例，裁剪部分内容 playerLayer.videoGravity = .resize // 拉伸填充
网络播放优化
对于网络流媒体,建议使用AVPlayerItem的preferredPeakBitRate控制码率：
playerItem.preferredPeakBitRate = 1024 * 1024 // 设置1Mbps码率
内存管理
当不再需要播放器时,需移除观察者并释放资源：
player.pause() player.removeTimeObserver(timeObserver) playerLayer.removeFromSuperlayer() player = nil
功能对照表
| 功能 | 实现方法 | 说明 |
|---|---|---|
| 播放控制 | player.play()/pause() | 基础播放暂停功能 |
| 播放速率 | player.rate = x.x | 支持快进/慢放（0.0~2.0） |
| 进度跳转 | player.seek(to: time) | 跳转到指定时间点 |
| 循环播放 | 监听player.actionAtItemEnd | 设置为.pause后手动重新播放 |
| 后台播放 | AVAudioSession.sharedInstance() | 需配置音频会话 |
相关问答FAQs
Q1: 如何实现视频播放时的自定义控制界面？
A1: 由于AVPlayer不自带UI，需自行创建控制条（如播放/暂停按钮、进度条），通过监听player的currentItem.timeControlStatus（.playing/.paused/.waiting）更新按钮状态，使用addPeriodicTimeObserver获取实时进度并更新UI,示例代码：
let progressSlider = UISlider() progressSlider.minimumValue = 0 progressSlider.maximumValue = Float(CMTimeGetSeconds(player.currentItem!.duration)) progressSlider.addTarget(self, action: #selector(seekToTime), for: .valueChanged)
Q2: 播放网络视频时如何处理缓冲进度？
A2: 通过AVPlayerItem的loadedTimeRanges属性获取已缓冲时间范围,计算缓冲百分比：
func updateBufferProgress() {
guard let item = player.currentItem else { return }
let loadedRanges = item.loadedTimeRanges
let firstRange = loadedRanges.first?.timeRangeValue
let startSeconds = CMTimeGetSeconds(firstRange?.start ?? .zero)
let durationSeconds = CMTimeGetSeconds(firstRange?.duration ?? .zero)
let bufferProgress = (startSeconds + durationSeconds) / CMTimeGetSeconds(item.duration)
print("缓冲进度: \(bufferProgress)")
}
可调用playerItem.addObserver监听loadedTimeRanges的变化,定期调用此方法更新UI。
