watchOS SwiftUI实现扬声器强制播放音效并恢复原音乐音量

核心思路 #

watchOS 不支持 overrideOutputAudioPort(_:)，但可以通过切换音频会话类别为 .playAndRecord 并启用 .defaultToSpeaker 选项，强制音效通过内置扬声器播放。同时需要提前保存原音频会话状态、系统音量，播放完成后逐一恢复。

步骤与代码实现 #

1. 定义状态变量

先预存需要恢复的关键状态：

import AVFoundation
import MediaPlayer

class SoundPlayer: NSObject, AVAudioPlayerDelegate {
    var audioPlayer: AVAudioPlayer?
    
    // 保存原音频状态
    private var originalCategory: AVAudioSession.Category?
    private var originalCategoryOptions: AVAudioSession.CategoryOptions = []
    private var originalVolume: Float = 0.0
    private var wasOtherAudioPlaying = false

2. 播放前准备（切换会话+调最大音量）

func playSound(from url: URL) {
        let session = AVAudioSession.sharedInstance()
        
        // 1. 保存当前状态
        originalCategory = session.category
        originalCategoryOptions = session.categoryOptions
        originalVolume = session.outputVolume
        wasOtherAudioPlaying = session.isOtherAudioPlaying
        
        // 2. 配置音频会话：强制扬声器播放
        do {
            // .playAndRecord + .defaultToSpeaker 是watchOS唯一能强制扬声器的方式
            try session.setCategory(.playAndRecord, mode: .default, options: .defaultToSpeaker)
            // 如果之前有音乐在播放，激活会话时通知系统后续恢复
            let activationOptions: AVAudioSession.ActivationOptions = wasOtherAudioPlaying ? .notifyOthersOnDeactivation : []
            try session.setActive(true, options: activationOptions)
        } catch {
            print("配置音频会话失败：\(error.localizedDescription)")
            return
        }
        
        // 3. 调至最大音量（系统音量是全局的，需用MPVolumeView修改）
        let volumeView = MPVolumeView()
        if let volumeSlider = volumeView.subviews.first(where: { $0 is UISlider }) as? UISlider {
            volumeSlider.value = 1.0
        }
        
        // 4. 初始化并播放音效
        do {
            audioPlayer = try AVAudioPlayer(contentsOf: url)
            audioPlayer?.delegate = self
            audioPlayer?.play()
        } catch {
            print("初始化音频播放器失败：\(error.localizedDescription)")
            // 播放失败也要恢复状态
            restoreAudioState()
        }
    }

3. 播放完成后恢复状态

实现 AVAudioPlayerDelegate 方法，在音效播放完毕后恢复原状态：

func audioPlayerDidFinishPlaying(_ player: AVAudioPlayer, successfully flag: Bool) {
        restoreAudioState()
    }
    
    private func restoreAudioState() {
        let session = AVAudioSession.sharedInstance()
        
        // 1. 恢复系统音量
        let volumeView = MPVolumeView()
        if let volumeSlider = volumeView.subviews.first(where: { $0 is UISlider }) as? UISlider {
            volumeSlider.value = originalVolume
        }
        
        // 2. 恢复原音频会话
        do {
            if let category = originalCategory {
                try session.setCategory(category, mode: .default, options: originalCategoryOptions)
            }
            // 通知系统恢复之前的音频播放
            try session.setActive(false, options: .notifyOthersOnDeactivation)
        } catch {
            print("恢复音频会话失败：\(error.localizedDescription)")
        }
        
        audioPlayer = nil
    }

关键注意事项 #

• 麦克风权限：使用 .playAndRecord 类别需要在 Info.plist 中添加 NSMicrophoneUsageDescription（麦克风使用描述），否则App会崩溃。即使你不实际使用麦克风，系统也会因该类别要求权限。
• 系统版本：确保部署目标为 watchOS 6.0+，上述API在该版本及以上稳定支持。
• 状态恢复可靠性：播放失败时也要调用 restoreAudioState()，避免原音频状态无法恢复。

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