使用AVPlayerViewController实现画中画(Pi
2024-04-25 本文已影响0人
喔牛慢慢爬
在iOS开发视频播放画中画(PiP)最简单的方法是使用AVPlayerViewController
实现现标准播放器,实际上使用AVPlayerViewController
播放器时将自动支持画中画(PiP)功能。
实现代码
- 配置Audio Playback Behavior,需要设置App 的AVAudioSession的Category为playback模式
do {
try AVAudioSession.sharedInstance().setCategory(.playback, mode: .moviePlayback, options: [])
try AVAudioSession.sharedInstance().setActive(true)
} catch {
print("无法设置音频会话类别: \(error)")
}
import UIKit
import AVKit
class ViewController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
self.view.backgroundColor = .black
}
func initPlayer() {
let _videoURL = "***播放地址***"
let _player = AVPlayer(url:_videoURL)
let _playerVC = AVPlayerViewController()
_playerVC.delegate = self
if AVPictureInPictureController.isPictureInPictureSupported() {
_playerVC.allowsPictureInPicturePlayback = true
if #available(iOS 14.2, *) {
_playerVC.canStartPictureInPictureAutomaticallyFromInline = true
}
}
_playerVC.player = _player
self.present(playerViewController, animated: true) {
_player.play()
}
}
override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) {
self.initPlayer()
}
}
PiP代理方法
// 通知代理 AVPlayerViewController 即将开始全屏显示其内容
func playerViewController(_ playerViewController: AVPlayerViewController, willBeginFullScreenPresentationWithAnimationCoordinator coordinator: UIViewControllerTransitionCoordinator) {
print("")
}
// 通知代理 AVPlayerViewController 将停止全屏显示其内容
func playerViewController(_ playerViewController: AVPlayerViewController, willEndFullScreenPresentationWithAnimationCoordinator coordinator: UIViewControllerTransitionCoordinator) {
print("")
}
// 即将启动画中画(Picture in Picture, PiP)模式时调用此方法
// 可以在此方法中设置或更新一些相关的 UI 元素或状态,以反映视频即将进入画中画模式。
func playerViewControllerWillStartPictureInPicture(_ playerViewController: AVPlayerViewController) {
print("")
}
// 已经进入画中画模式时调用此方法
// 用法:用于更新 UI 或进行其他准备工作,以支持画中画模式。
func playerViewControllerDidStartPictureInPicture(_ playerViewController: AVPlayerViewController) {
print("")
}
// 当画中画模式启动失败时调用此方法
// 用法:处理画中画模式启动失败时的错误。
func playerViewController(_ playerViewController: AVPlayerViewController, failedToStartPictureInPictureWithError error: Error) {
print("")
}
// 即将结束画中画模式时调用此方法
// 用法:在视频退出画中画模式前进行收尾工作,更新 UI 或做一些清理
func playerViewControllerWillStopPictureInPicture(_ playerViewController: AVPlayerViewController) {
print("")
}
// 已经结束画中画模式时调用此方法
// 用法:用于恢复正常播放状态,或者处理画中画模式结束后的逻辑
func playerViewControllerDidStopPictureInPicture(_ playerViewController: AVPlayerViewController) {
print("PiPVC:playerViewControllerDidStopPictureInPicture")
}
// 返回 true 或 false,指示在启动画中画时播放器是否应自动关闭。
// 用法:如果希望在进入画中画模式时关闭 AVPlayerViewController,则返回 true,否则返回 false。
func playerViewControllerShouldAutomaticallyDismissAtPictureInPictureStart(_ playerViewController: AVPlayerViewController) -> Bool {
return true
}
// 当画中画模式结束时,恢复用户界面。如果 AVPlayerViewController 在启动画中画后关闭,该方法可用于恢复 UI。
// 用法:用于确保在结束画中画后,用户界面恢复到正确的状态。确保调用 completionHandler 来表示恢复工作已经完成。
func playerViewController(_ playerViewController: AVPlayerViewController, restoreUserInterfaceForPictureInPictureStopWithCompletionHandler completionHandler: @escaping (Bool) -> Void) {
completionHandler(true)
}
PS1:从iOS 14开始,画中画用户界面提供了允许用户在视频中向前和向后跳转的控件。默认情况下,系统为iOS14或更高版本中链接的应用程序启用这些控件。如果您需要限制跳过内容以获得法律免责声明或广告,请在视频的所需部分使用requiresLinearPlayback。一旦您可以再次允许seek,请将此属性设置为false。
PS2:当用户在播放器界面中选择PiP按钮时,PiP播放开始。在iOS和iPadOS中,如果您的视频以全屏模式播放,并且用户退出应用程序,则PiP播放会自动开始。当视频的宽度没有填满整个屏幕时,请使用canStartPictureInPictureAutomaticyFromInline来指示视频是主要焦点。在任何一种情况下,播放器窗口都会最小化为可移动的浮动窗口。
通常情况下,系统会自动暂停视频的场景下,因此您不需要根据激活状态暂停视频。