SwiftUI中正确设置MPRemoteCommandCenter及避免重复实例问题

关于是否会重复创建实例的问题 #

MPRemoteCommandCenter.shared()是系统维护的全局单例，无论调用多少次，返回的都是同一个实例，不存在重复创建实例的问题。
但如果直接在视图的onAppear修饰符中调用你写的配置方法，会出现重复添加事件回调的问题：SwiftUI视图会随状态刷新、导航切换反复触发onAppear，每次调用addTarget都会新增一个回调注册，最终导致点击远程控制按钮时，一次操作触发多次播放/暂停逻辑。

正确的配置时机与位置 #

• 不要将配置逻辑放在视图层的生命周期回调（如onAppear）中：这类回调和UI页面生命周期绑定，触发时机不稳定，还容易出现回调捕获的player、页面实例失效的问题。
• 最佳配置时机：在你的音频播放核心管理类（推荐实现为全局单例的ObservableObject，和播放器生命周期绑定）的初始化方法中，完成AVAudioSession会话配置、播放器实例初始化后，一次性调用配置方法即可。

  前置要求：必须先将AVAudioSession的类别设置为playback并成功激活，否则远程控制中心的命令不会响应。

• 动态调整场景的处理：如果需要根据页面切换更换不同的远程控制逻辑，要在视图的onDisappear回调中调用对应命令的removeTarget方法，清空之前注册的回调，避免逻辑残留。

现有代码优化方案 #

你当前的代码缺少重复回调防护、循环引用防护，优化后的参考实现如下：

import MediaPlayer
import AVFoundation

class AudioPlayerManager: ObservableObject {
    // 全局单例，和App生命周期保持一致
    static let shared = AudioPlayerManager()
    private var player: AVPlayer?
    @Published var isPlaying = false
    
    private init() {
        // 1. 先配置音频会话
        try? AVAudioSession.sharedInstance().setCategory(.playback, mode: .default)
        try? AVAudioSession.sharedInstance().setActive(true)
        // 2. 初始化播放器逻辑（略）
        // 3. 配置远程控制中心
        setupRemoteControlCenter()
    }
    
    func setupRemoteControlCenter() {
        guard let player = player else { return }
        let commandCenter = MPRemoteCommandCenter.shared()
        
        // 先清空对应命令下已注册的所有target，避免重复回调
        commandCenter.playCommand.removeTarget(nil)
        commandCenter.pauseCommand.removeTarget(nil)
        // 按需处理其他命令，比如上一首、下一首、拖动进度等
        
        // 注册播放命令
        commandCenter.playCommand.addTarget { [weak self] _ in
            guard let self = self else { return .commandFailed }
            if !player.isPlaying {
                player.play()
                self.isPlaying = true
                return .success
            }
            return .commandFailed
        }

        // 注册暂停命令
        commandCenter.pauseCommand.addTarget { [weak self] _ in
            guard let self = self else { return .commandFailed }
            if player.isPlaying {
                player.pause()
                self.isPlaying = false
                return .success
            }
            return .commandFailed
        }
    }
    
    // 播放器销毁、不再需要远程控制时调用，清空所有注册
    func teardownRemoteControlCenter() {
        let commandCenter = MPRemoteCommandCenter.shared()
        commandCenter.playCommand.removeTarget(nil)
        commandCenter.pauseCommand.removeTarget(nil)
    }
}

优化点说明 #

• 配置前先调用removeTarget(nil)清空已有回调，即使多次调用配置方法也不会出现重复触发问题
• 回调闭包中使用[weak self]弱引用持有管理类实例，避免循环引用导致的内存泄漏
• 将配置逻辑下沉到播放器管理层，和播放器生命周期绑定，不受UI页面刷新、跳转的影响

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