如何让AVAudioPlayer不受iPhone系统媒体音量控制，始终满音量播放？

AVAudioPlayer的音量是与系统媒体音量相乘的，其volume属性范围为0.0到1.0，仅代表系统音量的占比，无法直接绕过系统音量限制。要实现不受系统媒体音量影响、始终以硬件最大音量播放的需求，需要改用AVAudioEngine来控制音频增益。

解决方案步骤 #

1. 配置AVAudioSession为.playback类别并激活，确保音频播放的优先级
2. 使用AVAudioEngine加载音频文件，通过计算增益抵消系统音量的影响
3. 调度音频播放并处理循环逻辑

完整代码示例 #

import AVFoundation

var audioEngine: AVAudioEngine?
var playerNode: AVAudioPlayerNode?

func playProgressToneIgnoringSystemVolume() {
    guard let soundURL = Bundle.main.url(forResource: "ProgressTone", withExtension: "mp3") else {
        print("Error: Audio file 'ProgressTone.mp3' not found.")
        return
    }
    
    // 配置音频会话
    let audioSession = AVAudioSession.sharedInstance()
    do {
        try audioSession.setCategory(.playback, mode: .default)
        try audioSession.setActive(true)
    } catch {
        print("Error configuring audio session: \(error.localizedDescription)")
        return
    }
    
    // 初始化音频引擎组件
    audioEngine = AVAudioEngine()
    playerNode = AVAudioPlayerNode()
    guard let engine = audioEngine, let node = playerNode else {
        print("Error initializing audio engine components.")
        return
    }
    
    engine.attach(node)
    
    // 加载目标音频文件
    do {
        let audioFile = try AVAudioFile(forReading: soundURL)
        let format = audioFile.processingFormat
        
        // 连接播放器节点到引擎输出
        engine.connect(node, to: engine.mainMixerNode, format: format)
        
        // 计算增益：抵消系统媒体音量的影响，确保实际播放为硬件最大音量
        let systemVolume = audioSession.outputVolume
        guard systemVolume > 0 else {
            print("System volume is zero, cannot calculate valid gain.")
            return
        }
        let gain = 1.0 / systemVolume
        node.volume = Float(gain)
        
        // 调度音频文件播放，完成后自动循环
        node.scheduleFile(audioFile, at: nil, completionHandler: { [weak self] in
            self?.playProgressToneIgnoringSystemVolume()
        })
        
        // 延迟0.5秒后启动引擎并播放
        DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
            do {
                try engine.start()
                node.play()
                print("Progress tone playing at max volume, ignoring system settings.")
            } catch {
                print("Error starting audio engine: \(error.localizedDescription)")
            }
        }
        
    } catch {
        print("Error loading audio file: \(error.localizedDescription)")
    }
}

// 停止播放并释放资源的方法
func stopProgressTone() {
    playerNode?.stop()
    audioEngine?.stop()
    audioEngine?.reset()
    audioEngine = nil
    playerNode = nil
    
    // 停用音频会话（可选，根据业务需求调整）
    do {
        try AVAudioSession.sharedInstance().setActive(false)
    } catch {
        print("Error deactivating audio session: \(error.localizedDescription)")
    }
}

注意事项 #

• 当系统音量为0时，需添加额外处理逻辑（比如提示用户调整音量，或设置默认增益值）
• .playback类别会让音频忽略侧边物理静音开关，若需要受静音开关控制，可调整类别为.ambient，但此类别仍会受系统音量影响，不建议用于当前需求
• 播放结束后务必调用stopProgressTone()释放资源，避免内存泄漏

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