SwiftUI实现背景音乐与音效共存及静音切换按钮方案

一、修复音频同时播放问题 #

你的代码使用全局单一AVAudioPlayer实例，导致新音频播放时会替换旧实例，直接中断背景音乐。要实现同时播放，需完成两点：配置音频会话允许混音、分开管理背景音乐与音效播放器。

1. 封装音频管理类 #

创建ObservableObject类统一管理音频，方便SwiftUI监听状态变化：

import AVFoundation
import Combine

class AudioManager: ObservableObject {
    // 背景音乐播放器实例
    private var backgroundPlayer: AVAudioPlayer?
    // 保存背景音乐原始音量，用于静音切换
    private var backgroundOriginalVolume: Float = 1.0
    // 静音状态，@Published让SwiftUI自动监听更新
    @Published var isBackgroundMuted = false
    
    init() {
        // 配置音频会话，允许多音频混音播放
        do {
            try AVAudioSession.sharedInstance().setCategory(
                .playback,
                mode: .default,
                options: .mixWithOthers
            )
            try AVAudioSession.sharedInstance().setActive(true)
        } catch {
            print("音频会话配置失败: \(error.localizedDescription)")
        }
    }
    
    // 启动背景音乐（无限循环）
    func startBackgroundMusic(sound: String, type: String) {
        guard let path = Bundle.main.path(forResource: sound, ofType: type) else {
            print("找不到背景音乐文件")
            return
        }
        do {
            backgroundPlayer = try AVAudioPlayer(contentsOf: URL(fileURLWithPath: path))
            backgroundPlayer?.numberOfLoops = -1 // 设置为无限循环
            backgroundPlayer?.volume = isBackgroundMuted ? 0 : backgroundOriginalVolume
            backgroundPlayer?.play()
        } catch {
            print("背景音乐播放失败: \(error.localizedDescription)")
        }
    }
    
    // 播放一次性音效
    func playSoundEffect(sound: String, type: String) {
        guard let path = Bundle.main.path(forResource: sound, ofType: type) else {
            print("找不到音效文件")
            return
        }
        do {
            // 每次创建新的播放器实例，不影响背景音乐的播放状态
            let effectPlayer = try AVAudioPlayer(contentsOf: URL(fileURLWithPath: path))
            effectPlayer.play()
        } catch {
            print("音效播放失败: \(error.localizedDescription)")
        }
    }
    
    // 切换背景音乐静音状态
    func toggleBackgroundMute() {
        isBackgroundMuted.toggle()
        backgroundPlayer?.volume = isBackgroundMuted ? 0 : backgroundOriginalVolume
    }
}

2. 在ContentView中调用 #

import SwiftUI

struct ContentView: View {
    // 实例化音频管理器
    @StateObject private var audioManager = AudioManager()
    
    var body: some View {
        VStack(spacing: 20) {
            // 静音切换按钮
            Button(action: {
                audioManager.toggleBackgroundMute()
            }) {
                Image(systemName: audioManager.isBackgroundMuted ? "speaker.slash.fill" : "speaker.fill")
                    .font(.title)
            }
            
            // 播放按钮音效示例
            Button("播放按钮音效") {
                audioManager.playSoundEffect(sound: "button", type: "mp3")
            }
        }
        .onAppear {
            // 页面加载时自动启动背景音乐
            audioManager.startBackgroundMusic(sound: "background", type: "mp3")
        }
    }
}

二、核心逻辑说明 #

• 音频会话配置：AVAudioSession.Category.playback确保应用后台也能播放音频，options: .mixWithOthers允许多个音频流同时播放，不会互相抢占中断。
• 播放器分离：背景音乐用持久实例实现循环播放，音效每次创建新实例，播放完成后自动释放，不占用额外资源。
• 静音实现：通过切换音量而非暂停播放来实现静音，保留背景音乐的播放状态，取消静音时直接恢复原音量，无需重新启动。

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