Swift中实现耳机播放/暂停、切歌、音量调节按钮响应的技术求助

Got it, let's get your audio player responding to those headset Play/Pause, skip, and volume controls! Here's a straightforward implementation using MPRemoteCommandCenter — I’ll break it down with full code examples and key notes.

Step 1: Setup the Remote Command Center #

You’ll need to configure the shared MPRemoteCommandCenter instance (usually when your app starts or your audio player initializes) to handle each headset command. Here’s a reusable audio manager class that takes care of all the heavy lifting:

import AVFoundation
import MediaPlayer

class AudioPlayerManager {
    static let shared = AudioPlayerManager()
    private var audioPlayer: AVAudioPlayer?
    // 假设你有一个歌曲列表和当前播放索引
    private let trackList = ["track1.mp3", "track2.mp3", "track3.mp3"]
    private var currentTrackIndex = 0
    
    func setupRemoteControls() {
        let commandCenter = MPRemoteCommandCenter.shared()
        
        // 处理播放命令
        commandCenter.playCommand.addTarget { [weak self] _ in
            self?.playCurrentTrack()
            return .success
        }
        
        // 处理暂停命令
        commandCenter.pauseCommand.addTarget { [weak self] _ in
            self?.pauseCurrentTrack()
            return .success
        }
        
        // 上一曲
        commandCenter.previousTrackCommand.addTarget { [weak self] _ in
            self?.skipToPreviousTrack()
            return .success
        }
        
        // 下一曲
        commandCenter.nextTrackCommand.addTarget { [weak self] _ in
            self?.skipToNextTrack()
            return .success
        }
        
        // 音量加减（可选：系统默认会调整系统音量，这里添加自定义逻辑）
        commandCenter.volumeUpCommand.addTarget { [weak self] _ in
            guard let player = self?.audioPlayer else { return .commandFailed }
            player.volume = min(player.volume + 0.1, 1.0)
            return .success
        }
        
        commandCenter.volumeDownCommand.addTarget { [weak self] _ in
            guard let player = self?.audioPlayer else { return .commandFailed }
            player.volume = max(player.volume - 0.1, 0.0)
            return .success
        }
    }
    
    // MARK: - Audio Playback Logic
    private func playCurrentTrack() {
        guard currentTrackIndex < trackList.count else { return }
        
        let trackName = trackList[currentTrackIndex]
        guard let trackURL = Bundle.main.url(forResource: trackName, withExtension: nil) else {
            print("找不到音频文件: \(trackName)")
            return
        }
        
        do {
            audioPlayer = try AVAudioPlayer(contentsOf: trackURL)
            audioPlayer?.play()
            updateNowPlayingMetadata()
        } catch {
            print("播放失败: \(error.localizedDescription)")
        }
    }
    
    private func pauseCurrentTrack() {
        audioPlayer?.pause()
        updateNowPlayingMetadata()
    }
    
    private func skipToPreviousTrack() {
        currentTrackIndex = max(currentTrackIndex - 1, 0)
        playCurrentTrack()
    }
    
    private func skipToNextTrack() {
        currentTrackIndex = min(currentTrackIndex + 1, trackList.count - 1)
        playCurrentTrack()
    }
    
    // MARK: - Update Lock Screen & Control Center
    private func updateNowPlayingMetadata() {
        guard let player = audioPlayer else { return }
        
        var nowPlayingInfo = [String: Any]()
        // 设置歌曲信息（根据你的实际数据替换）
        nowPlayingInfo[MPMediaItemPropertyTitle] = "歌曲 \(currentTrackIndex + 1)"
        nowPlayingInfo[MPMediaItemPropertyArtist] = "我的音频播放器"
        // 播放进度和时长
        nowPlayingInfo[MPNowPlayingInfoPropertyElapsedPlaybackTime] = player.currentTime
        nowPlayingInfo[MPMediaItemPropertyPlaybackDuration] = player.duration
        // 播放状态（1.0=播放，0.0=暂停）
        nowPlayingInfo[MPNowPlayingInfoPropertyPlaybackRate] = player.isPlaying ? 1.0 : 0.0
        
        MPNowPlayingInfoCenter.default().nowPlayingInfo = nowPlayingInfo
    }
}

Step 2: Initialize the Manager #

Call the setup method when your app launches (in AppDelegate or SceneDelegate):

// 在AppDelegate中
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 初始化音频会话（后台播放需要）
    do {
        try AVAudioSession.sharedInstance().setCategory(.playback, mode: .default)
        try AVAudioSession.sharedInstance().activate()
    } catch {
        print("音频会话初始化失败: \(error)")
    }
    
    AudioPlayerManager.shared.setupRemoteControls()
    return true
}

Key Notes to Make This Work #

• Background Playback: If you want your app to respond to headset controls even when in the background, enable the Audio, AirPlay, and Picture in Picture background mode in your project's Capabilities tab.
• Audio Session: Setting the audio session category to .playback ensures your app can play audio even when the device is silent or locked.
• Now Playing Info: Updating MPNowPlayingInfoCenter is optional but highly recommended — it makes your app show up in the lock screen and Control Center with proper playback controls.
• Command Return Values: Return .success when the command is handled correctly, or .commandFailed if something goes wrong (this tells the system your app couldn't process the command).

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