Swift全局播放器Widget开发：跨控制器持久化显示实现问询

我刚好做过类似的全局播放控制Widget，完全符合你说的「从底部推开其他控制器内容而非覆盖」的需求，下面给你一套可落地的实现方案：

一、核心设计思路 #

要实现这种「推开式」的持久Widget，不能直接用覆盖式的overlay，核心是动态调整根控制器视图的Frame，同时把Widget视图添加到Window层级（确保全局可见）。这样当Widget显示时，根控制器的内容会被向上推，留出底部的Widget空间；隐藏时根视图恢复全屏，Widget随之消失。

二、第一步：封装PlayerWidget控制器 #

先创建一个专门的PlayerWidgetViewController，负责播放控制UI和逻辑：

import UIKit

class PlayerWidgetViewController: UIViewController {
    // 定义Widget固定高度，比如60pt
    static let widgetHeight: CGFloat = 60
    
    // MARK: - UI组件
    private let songNameLabel: UILabel = {
        let label = UILabel()
        label.textColor = .white
        label.font = .systemFont(ofSize: 14, weight: .medium)
        return label
    }()
    
    private let playPauseButton: UIButton = {
        let btn = UIButton(type: .system)
        btn.setImage(UIImage(systemName: "pause.fill"), for: .normal)
        btn.tintColor = .white
        btn.addTarget(self, action: #selector(togglePlayPause), for: .touchUpInside)
        return btn
    }()
    
    // MARK: - 生命周期
    override func viewDidLoad() {
        super.viewDidLoad()
        setupUI()
    }
    
    private func setupUI() {
        view.backgroundColor = .darkGray
        view.clipsToBounds = true
        
        // 添加UI组件并布局（用AutoLayout）
        view.addSubview(songNameLabel)
        view.addSubview(playPauseButton)
        
        songNameLabel.translatesAutoresizingMaskIntoConstraints = false
        playPauseButton.translatesAutoresizingMaskIntoConstraints = false
        
        NSLayoutConstraint.activate([
            songNameLabel.centerYAnchor.constraint(equalTo: view.centerYAnchor),
            songNameLabel.leadingAnchor.constraint(equalTo: view.leadingAnchor, constant: 16),
            
            playPauseButton.centerYAnchor.constraint(equalTo: view.centerYAnchor),
            playPauseButton.trailingAnchor.constraint(equalTo: view.trailingAnchor, constant: -16),
            
            view.heightAnchor.constraint(equalToConstant: Self.widgetHeight)
        ])
    }
    
    // MARK: - 播放控制逻辑
    @objc private func togglePlayPause() {
        // 这里调用你的播放控制逻辑，比如通知播放器切换状态
        NotificationCenter.default.post(name: NSNotification.Name("TogglePlayPause"), object: nil)
    }
    
    // 更新歌曲信息
    func updateSongInfo(name: String) {
        songNameLabel.text = name
    }
}

三、第二步：全局Widget管理类（单例） #

创建一个PlayerWidgetManager单例，统一管理Widget的显示、隐藏、布局适配，避免在多个地方分散逻辑：

import UIKit

class PlayerWidgetManager {
    static let shared = PlayerWidgetManager()
    private init() {}
    
    private var widgetVC: PlayerWidgetViewController?
    private weak var window: UIWindow?
    
    // 初始化Widget，传入当前Window（iOS13+从SceneDelegate获取）
    func setup(with window: UIWindow) {
        self.window = window
        self.widgetVC = PlayerWidgetViewController()
        // 先隐藏Widget
        widgetVC?.view.isHidden = true
        // 添加Widget的视图到Window
        if let widgetView = widgetVC?.view {
            window.addSubview(widgetView)
            // 初始布局：固定在底部，宽度全屏，高度固定
            widgetView.translatesAutoresizingMaskIntoConstraints = false
            NSLayoutConstraint.activate([
                widgetView.leadingAnchor.constraint(equalTo: window.leadingAnchor),
                widgetView.trailingAnchor.constraint(equalTo: window.trailingAnchor),
                widgetView.bottomAnchor.constraint(equalTo: window.bottomAnchor),
                widgetView.heightAnchor.constraint(equalToConstant: PlayerWidgetViewController.widgetHeight)
            ])
        }
        // 监听设备旋转，适配布局
        NotificationCenter.default.addObserver(self, selector: #selector(adjustRootViewFrame), name: UIDevice.orientationDidChangeNotification, object: nil)
    }
    
    // 显示Widget并调整根视图Frame
    func showWidget() {
        guard let window = window, let widgetVC = widgetVC else { return }
        widgetVC.view.isHidden = false
        adjustRootViewFrame()
    }
    
    // 隐藏Widget并恢复根视图Frame
    func hideWidget() {
        guard let window = window, let widgetVC = widgetVC else { return }
        widgetVC.view.isHidden = true
        window.rootViewController?.view.frame = window.bounds
    }
    
    // 更新Widget的歌曲信息
    func updateSongInfo(name: String) {
        widgetVC?.updateSongInfo(name: name)
    }
    
    // 调整根视图的Frame，留出Widget空间
    @objc private func adjustRootViewFrame() {
        guard let window = window, let widgetVC = widgetVC, !widgetVC.view.isHidden else { return }
        let widgetHeight = PlayerWidgetViewController.widgetHeight
        let rootViewFrame = CGRect(x: 0, y: 0, width: window.bounds.width, height: window.bounds.height - widgetHeight)
        window.rootViewController?.view.frame = rootViewFrame
    }
}

四、第三步：在App启动时初始化Widget #

根据iOS版本，在AppDelegate或SceneDelegate中初始化Widget：

iOS 13+（SceneDelegate） #

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    guard let windowScene = (scene as? UIWindowScene) else { return }
    let window = UIWindow(windowScene: windowScene)
    self.window = window
    
    // 设置你的根控制器
    let rootVC = UINavigationController(rootViewController: YourMainViewController())
    window.rootViewController = rootVC
    window.makeKeyAndVisible()
    
    // 初始化Widget管理器
    PlayerWidgetManager.shared.setup(with: window)
}

iOS 12及以下（AppDelegate） #

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    let window = UIWindow(frame: UIScreen.main.bounds)
    self.window = window
    
    let rootVC = UINavigationController(rootViewController: YourMainViewController())
    window.rootViewController = rootVC
    window.makeKeyAndVisible()
    
    PlayerWidgetManager.shared.setup(with: window)
    return true
}

五、第四步：关联播放状态控制Widget #

在你的播放器逻辑中，调用Widget管理器的方法来控制显示/隐藏：

// 开始播放时显示Widget并更新信息
func startPlaying(songName: String) {
    PlayerWidgetManager.shared.updateSongInfo(name: songName)
    PlayerWidgetManager.shared.showWidget()
}

// 停止播放时隐藏Widget
func stopPlaying() {
    PlayerWidgetManager.shared.hideWidget()
}

六、注意事项 #

• 适配安全区域：如果你的App需要适配底部安全区（比如iPhone X及以上），可以把Widget的底部约束改为window.safeAreaLayoutGuide.bottomAnchor，同时调整根视图的高度时减去安全区底部高度+Widget高度。
• ViewController转场适配：如果你的App有自定义转场动画，需要确保转场过程中根视图的Frame是正确的，可以在转场前后调用adjustRootViewFrame方法。
• 内存管理：Widget管理器中用弱引用持有Window，避免循环引用；Widget控制器的视图添加到Window后，记得在App退出时移除（可选，因为Window销毁时子视图会自动释放）。

内容的提问来源于stack exchange，提问作者Ruslan Sabirov