SwiftUI健身App：语音合成器+MusicKit旁白及Apple Music音量控制问题

核心结论 #

ApplicationMusicPlayer不支持通过代码直接调整音量——Apple Music的音频流受DRM保护，且其播放会话绑定系统全局音量，第三方App无权单独操控。以下是3种可行替代方案：

方案1：系统层面音频闪避（推荐） #

利用AVAudioSession的duckOthers选项，让语音合成器播放时自动压低Apple Music音量，结束后恢复，这是苹果官方适配多音频场景的标准方案：

import AVFoundation

// 配置语音合成的音频会话
do {
    let session = AVAudioSession.sharedInstance()
    // .duckOthers会触发系统自动降低其他音频的音量
    try session.setCategory(.playback, mode: .default, options: [.mixWithOthers, .duckOthers])
    try session.setActive(true)
} catch {
    print("音频会话配置失败: \(error.localizedDescription)")
}

• 无需手动干预Apple Music播放，完全由系统处理音量平衡，体验最流畅

方案2：引导用户调整全局音量 #

如果需要更灵活的手动控制，可在App内添加系统音量滑块（实际控制全局音频，而非单独Apple Music）：

import MediaPlayer
import AVFoundation

// 创建系统音量滑块（可嵌入SwiftUI视图）
struct SystemVolumeSlider: UIViewRepresentable {
    func makeUIView(context: Context) -> MPVolumeView {
        let volumeView = MPVolumeView(frame: .zero)
        volumeView.showsRouteButton = false
        return volumeView
    }
    
    func updateUIView(_ uiView: MPVolumeView, context: Context) {}
}

// 使用示例
struct ContentView: View {
    var body: some View {
        SystemVolumeSlider()
            .frame(width: 200, height: 40)
    }
}

• 需在UI上明确提示用户“此滑块调整系统全局音量”，避免误解

方案3：播放状态联动控制 #

若场景允许（比如高强度训练的指令间隙），可在语音播放前暂停Apple Music，结束后继续：

import MusicKit

let player = ApplicationMusicPlayer.shared

// 语音播放前记录状态
let wasPlaying = player.playbackState == .playing
if wasPlaying {
    player.pause()
}

// 执行语音合成播放（这里替换成你的语音播放逻辑）
func speakInstruction() {
    // ... 语音播放代码
}
speakInstruction()

// 语音结束后恢复播放（需根据实际语音时长调整延迟）
DispatchQueue.main.asyncAfter(deadline: .now() + 3) {
    if wasPlaying {
        player.play()
    }
}

• 适合对背景音乐连续性要求不高的场景，完全规避音量冲突问题

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