Swift中如何在UIWindow与视图间插入不遮挡内容的迷你音乐播放器

问题核心：直接将播放器添加到UIWindow上会使其成为最上层视图，遮挡下层可交互元素，且页面的滚动视图不会自动调整内边距避开播放器。以下是几种可行方案：

方案一：全局通知+页面内边距调整 #

这是兼容性最强的方案，适用于大多数场景：

1. 定义全局常量与通知

// 全局声明播放器高度（根据实际尺寸修改）
let kMiniPlayerHeight: CGFloat = 60

// 扩展通知名称，用于高度变化时通知页面更新
extension Notification.Name {
    static let miniPlayerHeightUpdated = Notification.Name("miniPlayerHeightUpdated")
}

2. 修正播放器约束并发送通知
   确保播放器添加高度约束，并在初始化/高度变化时通知所有页面：

Generate.miniPlayer.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
    Generate.miniPlayer.leftAnchor.constraint(equalTo: window!.leftAnchor),
    Generate.miniPlayer.rightAnchor.constraint(equalTo: window!.rightAnchor),
    Generate.miniPlayer.bottomAnchor.constraint(equalTo: window!.bottomAnchor),
    Generate.miniPlayer.heightAnchor.constraint(equalToConstant: kMiniPlayerHeight) // 新增高度约束
])
window?.addSubview(Generate.miniPlayer)

// 发送通知告知所有页面调整内边距
NotificationCenter.default.post(
    name: .miniPlayerHeightUpdated,
    object: nil,
    userInfo: ["height": kMiniPlayerHeight]
)

3. 在页面基类中监听通知并调整内边距
   创建一个所有页面继承的基类ViewController，统一处理内边距：

class BaseViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        NotificationCenter.default.addObserver(
            self,
            selector: #selector(updateBottomInset),
            name: .miniPlayerHeightUpdated,
            object: nil
        )
        // 初始化时立即调整一次
        updateBottomInset()
    }

    @objc private func updateBottomInset() {
        let playerHeight = kMiniPlayerHeight
        // 调整页面安全区域内边距，适配所有系统控件
        additionalSafeAreaInsets.bottom = playerHeight
        
        // 如果页面本身是滚动视图，额外调整滚动视图的内边距
        if let scrollView = view as? UIScrollView {
            scrollView.contentInset.bottom = playerHeight
            scrollView.scrollIndicatorInsets.bottom = playerHeight
        }
    }

    deinit {
        NotificationCenter.default.removeObserver(self)
    }
}

方案二：利用导航栏/ TabBar容器（更优雅） #

如果你的应用使用UINavigationController或UITabBarController，可以将播放器替换为系统的toolbar或自定义tabBar：

基于UINavigationController的实现： #

// 隐藏默认toolbar，替换为自定义播放器
navigationController?.setToolbarHidden(false, animated: false)
navigationController?.toolbar = Generate.miniPlayer

系统会自动处理所有页面的底部安全区域，无需手动调整内边距。

基于UITabBarController的实现： #

// 隐藏默认tabBar，添加播放器作为自定义tabBar
tabBar.isHidden = true
view.addSubview(Generate.miniPlayer)
// 约束播放器到视图底部，宽度与视图一致
NSLayoutConstraint.activate([
    Generate.miniPlayer.leftAnchor.constraint(equalTo: view.leftAnchor),
    Generate.miniPlayer.rightAnchor.constraint(equalTo: view.rightAnchor),
    Generate.miniPlayer.bottomAnchor.constraint(equalTo: view.bottomAnchor),
    Generate.miniPlayer.heightAnchor.constraint(equalToConstant: kMiniPlayerHeight)
])
// 同时设置所有子页面的additionalSafeAreaInsets.bottom为播放器高度

方案三：自定义Window重写安全区域（iOS 13+） #

创建自定义Window子类，重写安全区域内边距：

class CustomWindow: UIWindow {
    override var safeAreaInsets: UIEdgeInsets {
        var insets = super.safeAreaInsets
        insets.bottom += kMiniPlayerHeight
        return insets
    }
}

在SceneDelegate或AppDelegate中使用这个自定义Window，所有页面会自动继承修改后的安全区域。

内容的提问来源于stack exchange，提问作者Canberk Çakmak