SwiftUI自定义AVPlayer仅受静音开关控制、音量调节失效问题

你遇到的isMuted属性失效、物理音量键无法调节播放音量、音频仅受设备侧边静音开关控制的问题，核心原因是没有主动配置应用的AVAudioSession音频会话，和AVPlayer自身属性、AVPlayerViewController的配置没有直接关系。

iOS系统对音频行为的管控优先级高于播放器自身设置：

• 应用未主动配置音频会话时，会默认使用soloAmbient类别，该类别的默认规则就是：音频输出完全跟随侧边静音开关状态，静音开关打开时直接切断所有音频输出；此时按物理音量键调整的是系统铃声音量，而非媒体播放音量，所以会出现按键无调节效果的问题。
• 未激活正确的播放类音频会话时，AVPlayer的isMuted等音频控制属性会被系统会话规则覆盖，手动赋值无法生效。

在AVPlayer开始播放前，主动配置并激活适合视频播放场景的音频会话即可解决所有异常：

1. 音频会话配置代码如下，建议放在AVPlayer初始化完成后、调用play()方法之前执行：

do {
    // 配置为视频播放专用的会话类别，音频不会被侧边静音开关强制截断
    try AVAudioSession.sharedInstance().setCategory(.playback, mode: .moviePlayback)
    // 激活已配置的音频会话
    try AVAudioSession.sharedInstance().setActive(true)
} catch {
    print("音频会话初始化失败: \(error)")
}

2. 配置位置可以选在CustomVideoPlayer的makeUIViewController方法中，或者父视图VideoCacheView里AVPlayer实例创建完成的回调中，保证会话激活早于播放动作即可。

• 设备侧边静音开关不会再强制切断视频音频输出（如果需要保留跟随静音开关的逻辑，可以将会话类别替换为.ambient，但视频播放场景官方推荐使用.playback类别）
• 按压物理音量键会默认调节当前应用的媒体播放音量，不再控制系统铃声音量
• AVPlayer的isMuted属性恢复正常控制能力，可以通过代码手动切换静音状态

额外注意：你当前代码中注册的AVPlayerItemDidPlayToEndTime通知没有在组件销毁时移除，建议在Coordinator类中添加deinit方法移除观察者，避免循环引用和重复回调问题。

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